9 “F709 3023 


OL fl 


QVME 
Enhanc Q Atari 
sae \ } | ) HI 


Trou bleSHOoOter 


Volume 3 issue 1 price £2.50 


& ——— 
Founts Built in or Software 


QL Seene 


New Developments on QXL and 
Gold Card 


| Editor 
Helen Armstrong 


Publisher 
Mark Kasprowicz 


Advertising Manager 
dim Peskett 


Creative Director 
John Stanley 


Graphic Artist 
Stevie Billington 


Magazine Services 
| Linda Miller, Frances Maxwell, 
Pauline Wakeling 


Sinclair QL World, 
Published by Arcwind Ltd. 
The Blue Barn, 

Tew Lane, Wootton, 
Woodstock, 

Oxon. OX7 1HA 

Tel; 0993 811181 

Fax: 0993 811481 

ISSN 026806X 


If you have any comments or 
difficulties please write to the 
editor and we will do our best 
to deal with your problem in 
the magazine, though we 
cannot guarantee individual 
replies 

| Back issues are available 
from the publisher price £2.50 

UK, £2.99 Europe. Overseas 
rates on request. 


Subscriptions from: Arcwind 
The Blue Bam, Tew Lane, 
Wootton, Woodstock, Oxon. 
OX7 1HA 

UK: £23.40 

Europe: £32.90 

Rest of World: £40.90 


Reprographic Services: 
Eclipse, Brook Street, 
Watlington, Oxon. OX9 5JH. 
Distributed by: Seymour Press 
Ltd, Windsor House, 1270 
London Road, Norbury, 
London, SW16 4DH 


94 ARCWIND LTD 

air QL World is published 12 
times a year. All rights reserved. 
Reproduction in whole or in part 
without written permission is 
strictly prohibited. We welcome 
contributions, All material must be 
supplied with a SAE 


While all reasonable care is taken 
in compiling QL World, the 
publisher and its agents assume 
no responsibiity in affects arising 
therefrom. Opinions expressed 
are those of the authors. 


| Contén 


6 QL SCENE 
All-new Page Designer 3 .. Complete Indexer from DJC ... QL stock at W N Richardson... All 
Formats and other fairs .. Machine Code errata .. Enigma solution! 


8 OPEN CHANNEL 
Two kinds of 3D! ... Xchange glossary info corrected .. TRA command defined .. Backissue stats 


from Ripon. 


10 TROUBLESHOOTER 


Bryan Davies take an elongated look at built-in and software founts for printing 


12 REVIEW: QVME 
Wolfgang Lenerz runs Jochen Merz's high-grade QL graphics card for the Atari STe. 


15 THE NEW USER GUIDE - part 32 


Concepts: QL hardware from roms to disk drives. 


19 SUPERBASIC IN ACTION 


Simon Goodwin with the new TF Services analogue interfaces. 


22 CLUB ACCESS 


Contacts for QL user clubs around the world. 


23 QL SCENE 
Miracle - new QXL release - new Gold Card version on horizen ... New PD from SJPD.... Black 


Knight has Pointer Environment .. Avometers reach 70 years. 


24 MACHINE CODE FOR BEGINNERS - Part 8 


Alan Bridewell on chasing and changing screen pixels. 


31 MICRO ADS 


Coming Soon 
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Fairs Now! 


Don't forget the Quanta/ SQLUG 
workshop at.Napier University, 
Colington Road, Edinburgh on 
February 12th - contact Alan 
Pemberton on 031 660 1826 (early 
evenings) for information. 

And the International QL Meeting 
at the University of Bielefeld, Germany 
(near Munster) on February 19th - 
contact Franz Herrmann, E-mail: 
Franz_Herr- mann @ bn.maus.de D- 
538545 Ockenfels for information. 

We have some last minute infomra- 
tion about exhibitors and accommo- 
dation today: Miracle, TF Services, 
Progs, Qubbesoft, EEC, Grange 
Technology, Jurgen Falkenburg, Albin 
Hessler, NASA (Norway), Ergon 
Development, Qitaly, Oliver Fink 
(QSpread) and Jochen Merz are 
among those expected. 

For more information reach Andreas 
Rudlof on ++ (010 from UK) 49 2242 
85515, Franz Herrmann on ++49 228 
231480 or the Bielefeld Tourist 
Information office on ++49 521 
178844, Andreas has a faxable list of 
information and hotels for travellers. 


PAGE DESIGNER - THE NEXT GENERATION! 


DJC now has a completely re-written Desktop Publisher, Page Designer 3, 
THe Next Generation, ready for use. 

PD3, the new incarnation of old favouite Page Designer two, has been entirely 
rewritten (‘well, almost’) by author Barry Ansell for the QL in the 1990s, operating 
under todays’ extended QL environment to use pointer (mouse) control or key- 
board control. “QL Desktop Publishing Made Simple!” is the program's motto. 
Even so, it is a serious tool, and needs minimum 512K and SuperToolkit Il to 
run. It is also Gold Card and Minerva compatible. 

The four-disk package includes, with DP’s permission, Digital Precision's High 
Definition Font format, and new and more efficient built-in printer routines. 

The Ad instruction manual deals with the program menu by menu, and also 
has detailed information about page sizes, file checklists for all four disks, a sep- 
arate section on the Font Editor, and printed pages of clipart for guidance. 

PD3 costs £40 (Post free in UK, postage £1 per program (max. £3) overseas), 
or an update kit for £25. Various clipart packs are available for £10 or £12. All 
orders and requests for information to Dilwyn Jones Software, tel. 0248 
354023, 

QL World would like a review of PD3 from an experienced PD2 user or desk- 
top publishing user - we can supply software - and in due course we would like 


Complete indexer from DJC 


New from DUC is Qindex, a program to assist in producing sorted indexes for 
a book or file. Unlike database-type indexing programs, where the entries are 
typed into a list, you can load into this program a plain text file or Quill _doc, 
and flag words and phrases directly to be inserted into an index. The resulting 
index can be built up from several text files (such as chapters of a book or 
manual), not just one. 

There is a Search facility to find all occurences of an item to be indexed, 
Entries 


with sim- 
ilar refer- 
ences 9.@ QUICK TUTORIAL 
A quick step by step quide to prodm@ 
can be the text file supplied called SAMPI i 
Will be called SAMPLE_ndx. Ensure 3am | Plain | 
automat- FLP2_, or whichever drive you have 
5 9.1 Start the program as described 
ically 9.2 Select the DOCUMENT item in. th meee | Spaces fi 
iby press 9 the po. GT Char-sSpaces) 
com - \ : 
P the required drive if (t 
b ine d 7 the one shown. When you can see the filename 
‘ IPLE_tkt, move the pointer over it and Do. 
There is fgter the pregram has returned to the menu, press N to 
aneu index file, If the program says ‘Already 
an on- sts’, choose the Overurite optlon, 

Move the ‘hand’ pointer down inte the big box where the 
screen $ Gisplayed. The “hand' changes to a flashing red 
facility to E) Je the cursor over a word or phrase to be added to the 

index (e.g. the word TUTORIAL) and press E for a new entry. 
count 4A green marker_appears . _ —- = 
t h e 


number of entries. 

Once finished, the index can be exported to a text editor (if desired) for 
restyling etc. prior to printing. The program has a choice of text pitches from 10 
cpi to 20 cpi, allowing layouts of different numbers of columns. Other layout 
choices include: entries beginning with different characters can be separated 
with a blank line, or a line containing the single character as a header, for 
instance, Users can devise their own layouts, or move the index to another edi- 
tor for layout. ; 

Indexer is Gold Card and Minerva compatible, and works in the Pointer 
Environment (supplied), so that a mouse can be used if desired. It can also be 
driven entirely from the keyboard. 

The program is on disk only (35 in or 5.25 in) and needs an expanded mem- 
ory and Toolkit Il (normally built into the disk interface), A complete printed man- 
ual is included. 

QL World would like a review from an experienced indexer in due course. 
Indexer costs £20. Cheques etc. should be made payable to Dilwyn Jones 
Computing. Tel. 0248 354023. For address etc. see Dilwyn's ad. on the back 
cover of this issue of QL World. 
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QL STOCKS SOLDIERING ON 


Bill Richardson only has about 20 of his famous New QLs left! The unused 
QLs, complete with original packing and manual, are the last of the shipment 
bought by Bill from their warehouse several years ago, where they had appar- 
ently been laying neglected since the "boom days” of QLdom. 

Once this elite band have homes, it looks as though the last of the “first 
owner’ QLs will be gone for ever. The New QLs are still £120 for a JS package 
and £100 for the JM, and the price of a New QL includes a free one-year 
membership to Quanta, 

Bill accepts used QLs in any condition in part exchange, giving a £30 dis- 
count on the New QL prices. “We collect these for spares”, Bill explained. 
Richardson's “Backup QLs’” - just the QL and its PSU, with no paperwork or 
software, are on sale for £80 for JS and £65 the JM rom versions. The part 
exchange allowance on the purchase of Backup QLs is £15. 

As for replacement keyboard membranes, “QL membranes are OK, but 
not the Spectrums.’ It's too expensive now to order a whole batch of Spectrum 
membranes with sales very low. However, QL membranes and instructions for 
fitting them cost £9 from Richardson's. Other spares getting scarcer but still 
around are 8301 and 8302 chips for the QL, and ULAs for the microdrive units, 

Another threatened species is the microdrive cartridge. Manufacture of 
cassettes ground gradually to a halt some four years ago as documented in 
QL Word, but steady sleuthing of unused stocks and second-hand cartridges 
by people tike Bill has kept supplies coming. Bill reckons he has 3-400 left, 
and a sales turnover of about 200 a month, so if you want more microdrives, 
speak to him soon. Sample prices are 8 walletted second user cartridges, 


£15; filing box with 20 new cartridges, £45. 


Hardware designed by people currently in the QL market is selling steadily - 
Jugen Falkenburg’s I/O card at £235, and keyboard interfaces for PC-style 


keyboards, a popular QL mod, at around £75, depending on the kit. 


Phone Bill on 0753 888866 or send a medium SAE to W N Richardson 
(EEC), 18-21 Misbourne House, Chiltern Hill, Chalfont St. Peter, SLO SUE. 


Enigma Solution 


Here is the solution to the coded message from the Engima pro- 
gram printed in QL World IL9 (Geptember 1993), 

Decoding the first six letters using the Code Indicator Setting CAT will 
reveal the Main Code Key GNU from which, after re-setting, the mes- 
sage can be decoded as: 

‘if you are looking for a magazine which will stretch your horizons and 
expand your knowledge of this versatile little machine, the Sinclair QL 
World is for you, Sign up for a year's subscription now and take advan- 
tage of the latest offer. You'll never regret it" 

(George wrote that all by himself! He’s obviously due for a very suc- 
cessful second career as a diplomat!) 

Of course, there will not be any spaces, punctuation or capital letters. 
This is a mesage of 211 characters, which together with the sic charac- 
ters of the Main Code Key constitutes the total message length of 217 
characters. Remember that you can easily recover from an incorrect let- 
ter in the code, but never from a character omitted! If anyone wants 
more information, just write to us. 


Machine Code Listings Errata 


The followers of Alan Bridewell's Machine Code For Beginners were 
on the phone to use as soon as their QL World |l.12 hit the mat Anyone 
who wants a replacement copy of the pale listings on pages 27 and 28 
(and also on page 21 in DIY Toolkit), or any of the other listings in those 
articles, write to me with your address and which listings you want, and 
we will send you a fresh copy. Allow a little time, as we have to get the 
originals back from the printers (or from Alan) 

Some Machine Code beginners may want a reprint of Listing 1 from 
part 6, issue 119, in which some lines were omitted due to an obscure 


All Formats Diary 


In 1994, the All Formats Computer Fairs will be 
held monthly at three northern venues, and 
only occasionally in other places. 

The monthly fairs will take place at the National 
Motocycle Museum, junction 6 of the M42, oppo- 
site the National Exhibition Centre entrance (a 
very central location for many parts of the coun- 
try), Haydock Park Racecourse, J23 of the M6, 
between Manchester and Liverpool, and the 
Washington Leisure Centres at the top of the 
A1(M). 

A smaller number of fairs will be held in Bristol, 
Glasgow, the South East, Belfast and Cardiff. It 
seems that the All Formats Fairs have dropped 
out of London altogether. 

In the next two months the following Fairs are 
lined up: Jan 23 West Midlands Motorcycle 
Museum; Jan 29 Essex Brentwood Centre; Jan 
30 Surbiton Southborough School; Feb 12 
Haydock Park; Feb 13 National Motorcycle 
Museum; Feb 26 Northumbria Centre, 
Washington; Feb 27 Glasgow Woodside Hall. 

The events are open from 10am to 4pm, 
entrance adult £4 (£3 with voucher), £2 child; £2 
all comers after 2pm. A supply of “£1 off vouch- 
ers Can be obtained by sending an SAE to All 
Formats Fairs, Maple LEft, Stretton-an-Fosse, 
Moreton-in-Marsh, Gloucestershire GL56 9QX. 
Stands at the fairs cost £60 tel. 0608 662212. 
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OPEN 
CHANNEL 


Open Channel Is where 
you have the opportunity 
to voice your opinions In 
Sinclair QL World. Whether 
you want to ask for help 
with a technical problem, 
provide somebody with an 
answer, or just sound off 
about something which 
bothers you, write to: Open 
Channel, QL World, The 
Blue Bam, Tew Lane, 
Wootton, Woodstock OX7 
1HA 


Two Threes 


Following the review of 
Digital Precision's QMaths 2 
mathematics collection, | 
would like to point out that 
there are, in fact, two pro- 
grams called “3D Terrain” 
knocking about on the mar- 
ket at the moment! 

The other program was 
previously distributed by 
CGH Services (RIP) and is 


now handled by Dilwyn 
Jones Computing. My rea- 
sons for pointing this out are 
(a) pride and (b) blatant plug- 
ging of the product, since | 
co-wrote this version! 

The program included in 
the DP package is of 
American origin, and regular 
readers may recall that 
Bryan Davies reviewed both 
programs about a year ago, 
a couple of months apart. | 
am not rubbishing one in 
favour of the other! The two 
are very different and only 
share their name by chance. 
In fact, | would urge interest- 
ed readers to invest in both, 
since they fulfil different roles 
and are both low in price. 

If | may be allowed to 
briefly highlight some of the 
differences: the US program 
is a complex shape genera- 
tor with a very good graphi- 
cal capabilities (viewpoint, 
scale, colour, etc), whereas 
the GB program is a spread- 
sheet viewer, taking any 
exported Abacus spread- 
sheet data and supplying 
the results as a 3D surface, 
therefore allowing the user 
to input data. 

The US program produces 
a screen image by calculat- 
ing every pixel position, 
rather like a fractal viewer. 
The GB program is only 
concerned with calculating 
the end points of straight 
lines, which it combines with 
other similar lines to form a 
surface grid created from 
“diamond’-shaped elements. 
(Note: this is a bit like the dif: 
ference between colouring 
and texturing techniques in 
Virtual reality, which trade off 
absolute detail against 
speed, depending on the 
application) 

In anyone is interested in 
this history of the GB pro- 
gram, | originally wrote my 
version because | got dizzy 
looking at OS maps of the 
very hilly areas near home 
where | went mountain-bik- 
ing. Therefore, the name ‘S- 
D Terrain” seemed appropri- 
ate. In 1989, after successful- 
ly modifying Mike Lloyd's 
maths engine from his 3D 
graph series of the previous 
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year, | asked Richard 
Alexander of CGH Services if 
he thought much of the 
idea, which he did. The nec- 
essary copyright information 
was sorted out with Mike, 
but progress from the origi- 
nal to something pre- 
sentable was slow (my fault). 
Rich Mellor was given the 
task of compiling the pro- 
gram using Turbo, but in the 
end he modified the original 
code and improved the 
‘feel” of the program in 
many areas. 

From the outset, it was a 
hobby type of program, 
which is why it retains some 
of its amateur charm! Once 
the Basic loader program is 
set up to cope with the size 
of the latest version of DP's 
Lightning, and the Psion 
GPRINT_ort file is copied 
across to the host medium, 
all is fine, The lack of demo 
files (there are only five) is 
again my fault, since it was 
intended to fit on an unex- 
panded, diskless machine. 
The Basic development ver- 
sions ran on a 128K QL but 
the compiled version needs 
extra memory, although | 
think it may still squeeze 
onto a microdrive. 

The user can very easily 
enter data via Abacus, or 
anything that will Export data 
to Easel in the same way as 
Abacus. Endless demo files 
are relatively pointless, since 
3D-Terrain (GB) is a spread- 
sheet rather than a complex 
equation displayer, and the 
idea is that the users “get 
grubby” and stick their own 
numbers into the program. 
Of course, the data doesn't 
have to describe a land- 
scape, it could be rainfall, 
pressure, temperature, basi- 
cally any variable expressed 
over an area. The biggest 
demo file displays an actual 
landscape, but, as men- 
tioned in the manual, the 
program can handle four 
times as many data points 
than this image contains, 
limited by screen resolution, 
which ultimately affects all 
display programs. Gimmee 
a QXL with SVGA capabili- 
ties, please! 


Sony this letter has grown 
into a book! | hope it clear 
up any confusion, and peo- 
ple don't ring Dilwyn thinking 
it's the same program as is 
in the DP collection. 

lan Thompson 
Ripon 


Wrong 
Definition! 


Soon after | wrote my last 
letter to you | discovered an 
article [not in QL World or 
Quantal on Quill in 
Xchange which explained 
how the glossary worked. In 
the _doc files on the disk it 
only says: “These settings 
are automatically saved 
when you quit Quill’. Wrong, 
They aren't. The article adds: 
“By the QUIT command 
pressing ‘A’ (New - 
A=Abandon, and will only 
appear within the command 
box when defining a glos- 
sary file.” This is also wrong. 
If you type anything into 
Quill and try to quit before 
you save it, this option 
always Crops up. 

| experimented with this 
command and found it did 
save a glossary, but only 
once and then that was it | 
have not been able to save 
a glossary since, and | can- 
not edit the original which | 
did in a hurry, and only as a 
trial. What is happening 
here? 

| must confess that | have 
problems with computer 
manuals and often have to 
read them several times 
before understanding what | 
am really supposed to do, 
so | often make mistakes. | 
spent ages trying to work 
out why the date on the 
Minerva clock was always 
slow when | reset it, until | 
noticed that the time has to 
be reset in the Mini-config 
program: This and your 
request for reviewers for cer- 
tain programs recently leads 
me to suggest that you 
should run two review 
teams. One is “the experts’, 
who can read the manuals, 
extract the relevant informa- 
tion and run the program 
first, and the other, a collec- 


tion of people who, like me 
(there must be plenty of oth- 
ers) get totally lost in the 
instructions and technical 
language. 
| can, eventually, get things 
happening. Having rewritten 
the Boot file about twenty 
times, | now have QPAC2 
running beautifully and my 
problems with SERmous 
only occurred because | did 
as the adverts suggested 
and bought a cheap mouse. 
(Jochen Merz supplied me 
with a better one, and now 
that is wonderful as well) So 
maybe reviews by people 
like me might be a good 
idea to show the obvious 
mistakes that the experts 
would immediately notice 
and cure without a mention. 
Roy Wood 
Hamburg 
Germany 


We try to make sure our 
reviewers refer to the manu- 
als and discuss them, so 
that if they are hard to 
undersiand, people will be 
wamed. We strive to give an 
idea how good the software 
is overall, as everyone has 
some difficulties with new 
programs, often for reasons 
of compatibility with printers, 
or personal misunderstana- 
ings which it would not be 
fair to highlight in a general 
review. However, we want to 
know if anyone has persis- 
tent difficulties, Always get in 
touch with the manufacturer 
first if you have a problem. 
Most QL suppliers give 
good support (as every sup- 
plier should) 

Your method of writing a 
Boot program - doing it 20 
times over until it works well 
- would strike many of us as 
absolutely correct! There is a 
lot of “if at first you dont suc- 
ceea” in programming. 


TRA 


| was hoping to see the 
definition of the Basic com- 
mand TRA in the useful 
series the New User Guide. 
True, not all roms support 
this, but JS (presumably 
quite widespread) does. | 


find the command useful for 
printing such characters as 
“up arrow’ and “right arrow" 
on my Epson printer. Indeed, 
there is oblique reference to 
TRA in the section CRE- 
ATE_PRINTER_DRIVER in 
Digital precision’s manual for 
Perfection, So for those who 
are interested (and there 
must, or should in my opin- 
ion, be many users of 
Perfection) here is my defini- 
tion of TRA unravelled from 
its machine code. 


TRA address1 [address2} 
(US and above) 
Translation Command 


This command controls 
two tables, Serial Translation 
and Message. The first 
translates output to SER1 
and SER2, the second pro- 
vides the error messages. 

The default table trans- 
lates each byte to itself (ie it 
does nothing). This can be 
changed by specifying in 
address1 the position of a 
user table. This should con- 
tain the 7 bytes 
74,251 ,0,6,1,6,0 followed by 
255 bytes being the transla- 
tion of bytes 1 to 255. (Note 
that byte 0 is never altered) 
After this is an extension 
table. If any byte in the trans- 
lation table is zero then 
three bytes are taken from 
the extension table which is 
made up of a byte giving the 
number of translations fol- 
lowed by that number of 
groups of four bytes, the first 
of which is the byte to be 
translated, the remaining 
three being the three bytes 
actually sent to SER1 or 
SER2. 

lf address1 = 0, no change 
is made to the current 
Translation Table, 

If address1 = 1, the 
Translation Table reverts to 
the default 

Otherwise address1 is 
taken as the address of the 
new Table. 

A user Message Tabie 
can be set up by puiting 
address2 equal to the 
address of a user table. This 
table must start with the two 
bytes 74,251 followed by 29 


words giving the offset of 
each of the 29 messages 
frost he start of the table. 
Each message except the 
last two consists of one 
word containing the length 
of the message followed by 
the message itself. The last 
two messages have no ini- 
tial defining word. In fact, 
only 21 of the messages are 
true error messages, so the 
others ought to be copied to 
end of the user table from 
the default taxable. The 
address of the Message 
Table is held in SYS_VARS + 
$14A (usually $281 4A). 

If address2 = 0, the 
Message Table reverts to 
the default 

If address2 is omitted, no 
change is made to the cur- 
rent Table, 

Otherwise address2 is 
taken as the address of the 
new Table. 

George Gwilt 
Edinburgh 
Scotland 


Back Numbers 


In issue 10 | read of 
requests for back numbers 
of QLWorld. | have all copies 
of QLWorld, QL User (includ- 
ing the Special Launch 
Edition) and QLUB News 
issues 4-8.. | am willing to 
supply photocopies of 
requested articles. | do not 
have my own photocopier, 
but a local business will 
make copies for contribu- 
tions to charity of 10p a 
sheet, and these could be 
supplied at that prrice, plus 
price of a large envelope 
and postage. | have my own 
index of articles, not perfect 
but | can usually find things. 

On my copy of D-Day the 
first request is “Is there a 
ram disc available?" lm sure 
there is but | don’t know how 
to find it. Words of one sylla- 
ble, please. 

Arthur Nunn 
Ripon 
0765 689378 


Editor’s Notebook 


If any of the editorial pages look odd this 
month, it's quite likely to be my fault, as | have 
entered most of them, in the nightmare compa- 
ny of Hell's Monitor, which kept fading back into 
the darkness. whence it came. We examined its 
insides and threatened it with a major operation, 
and that seems to have settled it for a while ... 

This month we have news of an interesting 
new indexing program from Dilwyn Jones, and it 
looks as If Miracle, faced with directing their 
energies in many different difrections, are mak- 
ing determined plans to be in full control of as 
much of their sfotware, as well as their hardware, 
as possible for future developments. They also 
expect to have the first-demo SCSI card ready 


for Newport in May. 


Please note that Qubbesoft's workshop num- 
ber is 0376 347852, and not the one printed in 
last month's QLScene, Sorry, Ron. 
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Bryan Davies looks at the habits of computer founts. 


ull marks to Hewlett- 

Packard for service. 

Alf Kendall has an H- 

P DeskJet printer, 
which went sick a few 
months back. He thought 
the printer was no longer 
covered by warranty, being 
more than one year old, but, 
when he contacted Hewlett- 
Packard he was asked for 
the printer serial number 
and told it was still covered. 
The printer was duly collect- 
ed - yes, H-P arranged for it 
to be picked up - ona 
Friday. It arrived back, work- 
ing properly and with several 
parts replaced, the following 
Friday. This was a couple of 
weeks before Christmas, 
when one can _ usually 
expect delays. Advice with 
the printer tald him the war- 
ranty extends until spring 
1994, well past the end of 
the one-year nominal war- 
ranty period. As you might 
expect, Alf is a very satisfied 
customer. 

The DeskJet is a good 
printer, and justifiably popu- 
ar. There can be problems 
with the ink feed if the 
machine is not used regular- 
y. As with most inks, 
DeskJet cartridges can clog, 
so keep it flowing freely by 
printing the odd page every 
few days. lf the printer has to 
be left inactive for weeks, 
remove the cartridge, and 
cover the nozzle area; it 
might also be worth putting 
the cartridge back into its 
packet and sealing that with 
tape as tightly as possible. 

Ink cartridges are expen- 
sive, but the costs can be 
kept down with refills. Rather 
than waiting until nothing at 
all is coming out of the noz- 


zles, inject a little ink into the 
cartridge at regular intervals. 
A refill equivalent to the 
amount in two new cCar- 
tridges costs about £8-12 
plus VAT, 

My experience with the 
Canon BubbleJet BJ-10EX 
is that a cartridge left for 
months without use is too 
far gone to be worth trying to 
revive with a refill kit. You 
can get it printing again, but 
the quality is not good. 
Possibly, soaking the car- 
tridge in a suitable solvent 
for several hours would do 
the trick if you have more 
time than money. 


Printer Founts 


Bryan Orgar is puzzled by 
founts. Like most micro 
users, he is attracted to 
improving the appearance 
of his printed output, but 
finds it difficult to understand 
the terminology and tech- 
niques. Printing causes 
more heartache for most of 
us than any other facet of 
home computing, but life 
“before founts” was a whole 
lot simpler than it is now. 

Printers come with “built- 
in” founts. These appear on 
the test prints, which can be 
done without the printer 
being connected to a com- 
puter at all. These founts are 
comparable with those on 
the screen of the basic QL, 
as they are “library sets” of 
characters, default founts. 
Over the years, the built-in 
founts have increased and 
improved, and even fairly 
cheap dot matrix printers 
now have a reasonable set 
of founts. However, many 
people are not satisfied with 
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the basic founts, and look 
around for additional ones. 
This is where you get on 
the slippery slope. There are 
two main categories of addi- 
tional fount - those on plug- 
in fount cards or cartridges, 
and "soft founts’. As the 
name implies, plug-in cards 
contain extra founts, which 
effectively increase the built- 
in set These founts act just 
like the built-in ones. One 
major drawback of founts on 
cards is their cost; they usu- 
ally work out far more 
expensive than software 
founts, and | never recom- 
mend them, for this reason. 


Downloading 
Founts 


Software founts come in 
several varieties, but the 
general principle of opera- 
tion is much the same, The 
fount characters are stored, 
or generated, in the comput- 
er and “downloaded” to the 
printer. The manner of down- 
loading is not the same for 
all types of soft fount. One 
technique is to send com- 
plete fount sets to the printer 
before printing starts, or as 
required during printing. This 
may need plenty of storage 
in the printer; fount files can 
take up a lot of space. 

Some types of printer have 
little or NO memory available 
for storing founts. Dot matrix 
printers and inkjets come 
with far too little memory for 
whole sets of characters to 
be stored. For these, it is 
necessary to send fount 
characters more or less one 
by one, rather than whole 
libraries at once. There are 
considerable variations in 


speed between different 
techniques. Downloading a 
whole fount is a time-con- 
suming business but, once 
it has been done, the founts 
become effectively built-in 
and there is no great delay 
in printing from there on. 
Sending characters individu- 
ally means having to send 
some of them repeatedly, 
and this is a slow process, 

Soft founts can be stored 
in the computer as library 
sets, just as the basic founts 
are stored in a printer, 
except that the soft founts 
will be on hard disc whereas 
the printer ones will be in a 
rom chip. A big disadvan- 
tage of the library fount is 
that it has to be of a fixed 
size. For instance, Courier 
10-cpi (characters per inch) 
is one of many fixed sizes of 
the Courier fount, and can 
be stored in one fount file. If 
you want 12-cpi as well, that 
means another file. Add 
together the founts you want, 
and the sizes in each, and 
you arrive at quite a few files. 
File size tends to increase 
with Character size, so that 
different sizes of the same 
basic type (eg Times) can 
range from, say, 10 KB up to 
100 KB. 

An alternative is to gener- 
ate each size on demand. 
This is what happens with 
scalable founts. The basic 
designs of the characters 
are stored; as a collection of 
mathematical definitions, 
without any size being 
attached to them. When the 
request comes for a particu- 
lar size, the appropriate mul- 
tiplying factor is applied to 
produce the desired size. 
The resultant character is 
sent to the printer. This is a 


very flexible approach, which 
gives good quality print over 
a wide range of sizes. The 
fact that the characters are 
not stored as dots in a 
matrix means that enlarging 
them does not result in a 
corresponding increase in 
jagged edges. 


Scalable 
Founts 


Scalable founts do not 
have to be soft founts. They 
can be “firm founts", stored 
on firmware (on a chip). 
Some types of printer - 
notably inkjet and laser - 
come with built-in scalable 
founts. These are invariably 
preferable to the fixed-size 
founts which were standard 
in dot matrix printers for 
many years (and still are in 
cheap printers). 

Before switching to a laser 
printer, | had thought that the 
dot matrix printer had some 
advantages, but that idea 
soon disappeared. In almost 
every way, the dot matrix 
printer is less flexible. 
Perhaps the only advan- 
tage Is the ability to take 
continuous stationery. Even 
the ribbons can be very 
expensive, comparable in 
price to ink cartridges and 
laser toner. The cost of a 
colour ribbon for the Star 
LC24-200, for example, is 
about £10-11 plus VAT, and 
| am told that they do not 
last long. There are some 
inherent design weaknesses 
in dot matrix printers which 
cause trouble. One is the 
inability to print near to top 
or bottom of paper, because 
of the physical spacing 
between print head and bail 
bar, and the need to have 
enough paper to grip to 
keep it aligned. Another is 
noise. 

Inkjets have their faults, 
too. They tend not to have 
emulation modes compati- 
ble with your existing printer, 
this can make them unus- 
able if your application pro- 
grams do not have your 
specific printer drivers, You 
cannot simply use an Epson 
FX-80 driver and get at least 


a basic printout, as you can 
with most dot matrix printers. 

In principle, dot matrix 
printers can print the same 
soft founts as inkjet and 
laser printers. Bryan Orgar 
has a NEC Pinwriter P2200, 
which is usable with many 
soft founts. The difficulties 
arise with individual applica- 
tion programs and their 
printer drivers - or lack of 
them - and with individual 
founts. Bryan also uses 
WordPerfect, and he should 
have no great trouble finding 
a Suitable driver for that pro- 
gram. 


Create Printer 
Data 


However, he prefers his 
Perfection SE to 
WordPerfect. Digital 
Precision do not have a vast 
stock of drivers, but they 
allow you to custom-build 
your own, using their Create 
Printer Data routine and 
inserting the appropriate 
control codes for your print- 
er. This can be be painful 
with some printers, such as 
the H-P lasers, but should 
be no great job with the 
P2200. DP will give advice 
on creating drivers, but don't 
expect them to spend hours 
writing one for you at no 
charge. 

The Perfection driver can 
utilise the Strip function to 
enable the various built-in 
founts to be selected. As 
yet, the QL has not been 
favoured with masses of 
soft fount programs. We 
have had plenty of founts 
offered, but they generally 
are unusable by the aver- 
age person, because they 
are not automatically 
made available to the 
application programs. They 
can be made to replace 
the on-screen QL founts, 
which may create a pleas- 
ing visual effect but is no 
use for printing. 

Text87 has a graphics 
driver which enables the 
founts supplied with it to 
be printed exactly as they 
are displayed on the 


screen, a rare genuine 
WYSIWYG (what you see is 
what you get). There used to 
be a very good program 
(CuePrint) which provided 
masses of well-designed 
founts for dot matrix printers, 
but that program is, alas, no 
longer available. For the 
moment, there is no doubt 
that you are better off with 
an inkjet or laser printer, sim- 
ply because they have better 
built-in, and scalable, founts. 
Make sure your application 
program supports the printer 
you choose, though. 

When thinking about soft 
founts, you may need to 
forget characters as dis- 
crete ready-made objects. 
The tendency now is for 
text to be printed as graph- 
ics: each character is cre- 
ated, and sent to the print- 
er, as a “picture”. 

The expression “soft 
founts” was coined to 
describe library character 
sets. The main difference 
between soft founts and 
built-in printer ones is that 
soft founts are stored in 
the computer. 

On the other hand, 
graphics founts, such as 
those used with the 
Windows interface, are 
“soft" in that they are creat- 
ed by software, and are 
stored on hard disk, but 
the characters are trans- 
ferred to the printer as indi- 
vidual images. Some 
founts have both screen 
and printer files, but the 
Windows type now gener- 
ally use the same files for 
display and printing. 


Graphics 
Printing 


It is easy to be overcome 
by the wonders of new 
founts, but do not lose sight 
of the down-side. Graphical 
printing is usually much 
slower than printing with 
built-in characters - this 
makes a lot of difference 
when you take into account 
that the QL can be speeded 
up very little when printing 
graphic images. 

Using built-in founts is 


much faster. Also, text 
quality sent graphically 
from the computer to a dot 
matrix printer can be 
mediocre on paper, worse 
than built-in founts. You 
can trace a path of decline 
for print quality, from the 
typewriter-quality of the 
daisywhee!, down to the 
near-letter-quality on the 
dot matrix, down to graph- 
ic text to the dot matrix, 

Laser and inkjet printers 
do a very good job of print- 
ing graphically; much bet- 
ter than even a good dot 
matrix printer does. 


Odds and Ends 


The word has been 
passed to me that my 
chemical terminology is 
out of date. Specifically, 
isopropyl alcohol is now 
normally referred to “in the 
trade” as isopropanol. 
Likewise with ethanol, 
methanol etc. If you hap- 
pen to be a drag-racing 
fan, methano! should have 
been a familiar term for 
many years, but literature 
on disk cleaners doesn't 
often use the term iso- 
propanol. Now we know. 

The liquid itself is an 
evaporating alchohol 
cleaner, used in disk drive 
kits to clean the recording 
heads. It can be used for 
many other cleaning jobs, 
such as on the record 
heads of microdrives, It 
appears not to be strong, 
in the sense it is not liable 
to damage surfaces it 
comes into contact with, 
making it fairly safe to use 
for cleaning plastics. 

A supplier called Furst (?} 
is said to be offering the 
SMS2 operating system on 
rom chip for the Atari, at a 
price of about £135. There 
is a dedicated rom socket 
on some Atari mother- 
boards, and the SMS2 chip 
fits into that; this approach 
sounds to be somewhat 
different from the QL emu- 
lators sold up to now. | 
heard this on the 
grapevine. Has anyone any 
more details? 
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The future now? 
Wolfgang Lenerz 
uses the QL 
emulator for the 
Atari STe. 


INFORMATION 

Prices: QVME card: DM 
695 

Adapter: DM 90 

Suppller: Jochen Merz 
Software, Im stillen Winkel 
12, D-4100 DUISBURG 11 
Germany 


or some time, the 
Atari emulators 
were the best and 
only way to get a 
better, faster and more reli- 
able QL: buy an Atari, install 
an emulator card (which 
involved some brandishing 
of the soldering iron), and 
the Atari behaves like a QL 
As the Atari had a true 
68000 (instead of the QL’s 
68008) it was noticeably 
faster than the QL, especially 
in printing to the screen, as it 
is not hampered by the QL’s 
double access to the screen 
memory. A Mega ST with 4 
MB memory and a hard disk 
makes a formidable QL! 


> 
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When Atari brought 
out the STe (which is 
faster than the older ST 
series, being a 16 MHz 
machine), everybody 
waited for Jochen Merz 
to come up with an 
emulator for that 
machine - the old emu- 
lators would not work 
with it. That new emula- 
tor is finally here. It was 
very long in coming, 
and | suppose that Merz 
lost a few sales to the 
Gold Card by then (he 
says he didn’t). It is 
called the QVME card, 
because it plugs into 
the “VME bus” of an 
Atari Mega STe. 


On The Card 


There is not much to 
say on the physical 
description of the QVME 
card, AS you can see 
from Figure one, it is 
neatly finished, with a 
VME connector at one 
end. | confess that | was 
astonished by the num- 
ber of chips on it - the 
board is densely popu- 
lated, even though it 
uses high integration. It 
is a very professional 
product, there is no evi- 
dence of last minute 
tampering, or wires run- 
ning where — they 
shouldn't. 

Nice as the card may 
be, were it just another 
emulator, only adapted 
to the STe series, it 
would hardly be impor- 
tant enough to merit a 
review in QL World. But 
there is more to it. 

First of all, installation 
is very much simplified: 
The card simply plugs 
into the STe's VME bus. 
No soldering is required. 
The QVME card can 
only be used in Mega 
STes, as the 1024 STe 
does not have a VME 
bus. Given the country 
of origin, this apparent 
restriction of choice is 
not surprising: In 
Germany, the majority of 
Atari machines sold 
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were Mega ST(e) machines. 
There, the Atari was more 
seen as a (small) business 
machine, whereas in Britain 
it never really got over the 
games machine image. 

It should be emphasised 
that Jochen Merz also sells 
a Mega ST adaptor, so that 
those having an older Mega 
ST can also use the QVME 
card (one wire needs to be 
soldered in that case). This 
is the case for me: | have a 
Mega 4 ST, and with the use 
of the adaptor, | can use the 
QVME card. This is the con- 
figuration actually used to 
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Figure one: The QVME card 


write this review. Figure two 
shows the card comfortably 
installed inside the machine. 


Large Screen 


Once installed, the card 
must be connected directly 
to the monitor. Indeed, the 
QVME card is actually a 
fully-fledged graphics card 
for the STe which replaces 
the latter's internal circuitry. 
(Drivers to use it in Atari 
native mode are also provid- 
ed, but this does not work 
on ST machines, one needs 
a genuine STe) The reason 
for such a graphics card is 
that it can display resolu- 
tions much higher than the 
Atari can: resolutions up to 
1024x768 are possible - 
even in QL mode: more 
than four times the native QL 
screen! 
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Of course, one will need a 
suitable monitor, a multisync 
being the best Monitor size 
is also important. A 14 inch 
monitor can't really go much 
higher than the 832x416 res- 
olution in Figure three, or 
the letters are too small for 
comfort. With a 17-in m@ni- 
tor, that should be possible, 
though. A normal QL moni- 
tor will not be able to display 
a very high resolution 
screen, but an ordinary VGA 
screen will be able to dis- 
play at least 640x480 - not 
bad, considering how cheap 
VGA monitors are today. 


with Its VME connector. 


The QVME card does 
work with a normal QL mon- 
itor - but you will need to 
have someone make up a 
plug, as the card only has a 
‘normal’ (for the PC world 15- 
pin plug. Even on a normal 
QL monitor, it is possible to 
get resolutions higher than 
the normal QL resolution. 


Adapting 


To adapt the card to your 
monitor, a whole suite of 
new keywords are linked 
into Basic. These allow you 
to change resolutions, verti- 
cal and horizontal frame fre- 
quencies, vertical and hori- 
zontal overscan etc... 

Fortunately, these new 
keywords and their purpos- 
es are well explained in the 
manual. Initially, the screen 
will be set to QL compatible 
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resolutions and frequencies, 
it is thus a matter of includ- 
ing a few more lines of 
Basic in your boot file to 
change these. Once one 
has found a correct set of 
values, these can be pre- 
configured, so that even the 
Basic lines in the boot 
become obsolete. 

How does one find the 
best values? By trial and 
error - increasing (for 
example) the resolu- 
tions ever so slightly, 
until finding a suitable 
one. This raises two 
interesting points: 

First of all, this 
method seems a bit 
fussy: wouldn't it have 
been better to give a 
table with standard 
values? Perhaps the 
reason lies in the fact 
that there are too 
many different monitor 
types. Here, the manu- 
al gives a very stout 
warning: do not try to 
use frequencies higher 
than the ones suppor 
ed by your monitor, 
else you can (and willl) 
physically damage it. The 
manual adds: “Take this 
warning seriously!” So you 
have been warned. This is 
probably why it is left to 
each user to select the best 
frequencies for his/her moni- 
tor {you will need your moni- 
tors manual for that). 


Size Changes 


Second and incredibly, the 
display changes to the new 
size aS Soon as one types 
the Basic commands: it is 
possible to change resolu- 
tion ‘on the fly - and all soft- 
ware continues to function! 
Multitasking really takes on 
a new meaning as it is pos- 
sible to display several jobs 
at once. Likewise, there is 
now space enough to dis- 
play a very large list of files 
on the hard disk, without 
having to scroll through too 
many of them (see Figure 
foun). 

When programming, those 
using QD are also happy, as 
the window of that editor 


% 


can be enlarged, so that 
one can see many more 
lines at a single glance. 

So what is using the card 
like? First of all, having a 
high resolution QL (after all, 
that is what it boils down to) 
is addictive! At last there is 
enough space for a whole 
row of buttons at the top of 
the screen (see Figure 
three), visually recalling the 


Figure two: The QVME - a QL card Installed In an Atari STe. 


jobs running in my machine. 
It also becomes realistic to 
leave many window open, 
as somewhere part of it will 
show and thus can be 
‘picked’ quickly with the 
mouse. With a large screen, 
multitasking gathers a new 
dimension. This enables me 
to integrate the computer 
even more into my business 
life. | have written a suite of 
programs to assist me in (or 
automate) most material 
aspects of my law office 
(mainly follow-up of cases, 
accounting, standard letters 
etc). Now the AtaQL reflects 
even more closely the way | 
work, compelled (through 
telephone calls, urgencies 
etc.) to switch quickly from 
one task to another. In that 
sense, | can certainly say 
that the larger screen is - for 
me - a productivity tool. 


Several Things 
In addition to the possibili- 


ty of seeing several things at 
once, it also becomes possi- 


ble to see more (of a list, a 
letter, a deed etc) at once. 
This, again, speeds up my 
work - nothing can beat the 
humain eye/brain combina- 
tion to pick up fast salient 
facts from a screenfull of 
lines. Unfortunately, however, 
this latest possibility is still 
restricted: not all programs 
can make use of the large 
screen; only a few do. They 


run, but they still assume the 
the maximum screen size is 
512x256. Some programs 
(such as the QPAC 2 suite, 
QD, Qspread and so on) 
allow their screen size to be 
altered and of course, these 
programs can take advan- 
tage of the large screen. 
With one exception, they 
invariably run under the 
pointer environment, The 
exception is Text87 - it will 
adjust to a larger screen, 
even though it is not a point- 
er environment product. For 
various reasons, | don't use 
Text87, and my biggest 
lament is that | don't have a 
wordprocessor showing me 
more of a page! 

One aspect of interest 
might be the screen updat- 
ing. We all know by now 
that, in the QL, screen 
access is rather slow. On the 
Atari, this is not the case, so, 
compared to the QL, 
scrolling a page up or down 
in blindingly fast. With a larg- 
er screen, however, scrolling 
speed goes down again. 


This is easily explained. 
Suppose one scrolls the 
screen down by one pixel 
line. This means that the 
entire screen must be 
moved down one line. At a 
normal QL resolution of 
512x256 pixels in 4 colours, 
the processor must thus 
move 512*256/4 bytes (there 
are 4 pixels to a byte in 4 
colour mode) = 32768 
bytes. When using (say) 
a 1024*512 resolution 
with the card, the 
processor must move 
1024*512/4 bytes = 
131072 bytes, ie. four 
times as much a nor- 
mal QL! Despite that, 
scrolling on an AtaQL is 
still fast - as fast as a 
normal QL! 

Of course, there are 
some other niggles. To 
my mind, they are 
minor, but | know of oth- 
ers who do feel incom- 
moded. Perhaps the 
most lamented is that 
the emulator only allows 
Mode4. There is no 
Mode8 at all. | may be 
wrong, but to my knowl- 
edge, the only programs 
using ModeB are graphics 
programs, or games. | only 
rarely use the former - and 
the games | play work in 
Mode4. As | never use 
Mode, | can honestly say 
that | don’t miss its absence 
at all. 


Compatibility 


Also, there are some com- 
patibility problems: no pro- 
gram writing direct to the 
screen will work - the screen 
address does not lie at 
$20000 as in the QL. It 
seems to be somewhere in 
high memory. But there 
again, the majority of pro- 
grams writing direct to the 
screen are games... It must 
also be mentioned that 
some programs, even 
though they write directly to 
the screen, can be persuad- 
ed to run nevertheless: such 
as the Psion suite, all of 
which (except Easel, for 
obvious reasons) can run on 
the emulator. Indeed, in fig- 
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ure three, you can see Quill, 
being used to type this 
review (actually, | cheated, 
because the is the Quill of 
Turbo-Xchange, which can 
also be persuaded to run on 
the emulator). 

Another potential source 
of trouble could be the 
pointer environment, which 
ig automatically loaded into 
the machine. | personally 
think that the pointer envi- 
ronment is the best thing to 
have happened to the QL 
since its inception. | would 
actually refuse to work with a 
machine that didn't have it 
loaded, but there are some 
people who can't get to 
grips with it. 

| also have an unfulfilled 
wish. It is clear that the card 
can only display four 
colours. It would have been 
very nice, however, if | could 
choose what these colours 
were! The reason for that? 
Well, it would be nice to be 
able to replace the colour 
green {or red) by a grey. This 
would not make much differ- 
ence to already existing pro- 
grams, but | could then use 
white, black and grey to 
achieve some neat 3D 
effects in programs | write 
myself! Unfortunately, the 
colours are hard-coded in 
the QVME card, so that is 
not possible. 

All in all, though, these crit- 
icisms are minor. For me, the 
situation is simple: there is 
no program available on the 
QL which | would like to use, 
but which | can’t use 
because of incompatibility 
problems. The emulator is in 
my machine to stay! 


Future? 


The card addresses the 
point | perceive to be the 
biggest disadvantage of the 
QL: the screen. Indeed, if 
one looks at other comput- 
ers today, what most QL 
users find striking, is their 
display. Most software devel- 
oped today for, notably, PCs 
using Windows, just looks 
nice. Never mind, here, 
whether that software works 
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Figure four: A very large list of files can be displayed at once. 


(much of it doesn't) or does 
things you couldn't do with 
the QL (as is often, and very 
wrongly, stated) - the fact is 
that it is often pleasant to 
look at, heightening the 
interest in the program (and 
the computer). | firmly 
believe that it no longer is 
enough for a modern pro- 
gram to do what it sets out 
to do - it must also do it in a 
visually pleasing manner. 
This is difficult to achieve on 
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a normal QL display! It is 
incredible that a modern 
computer (and, even after 10 
years, the QL is still that!) 
should only have a highest 
resolution of 512x256 in 4 
colours. The QVME card cer- 
tainly puts that right! 
Moreover, due to a unified 
interface system, modern 
software on other (lesser!) 
computers is also often 
more easy to use - but if 
every QL developer could 


only be made to develop 
under the pointer environ- 
ment, the QL could also 
have that! 

‘The debate over the future 
of the QL has been going 
on for some time now, and it 
is no accident that the QXL 
card should be out soon. 
For those QL users having 
Mega ST{e) computers, the 
QVME card could be the 
best way to have that future, 
now, 
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programmable from Super-Basic. 130 DEFine PROCedure JOYSTICK 
This column demonstrates applications for en REUAEk Gb Tee Analogue joyetick input 
i : i 1560 x=100 : y=100 : OVER -1 
the new Analogue interface, with working 16U BLOCK 10,10,x,y,2 
Super Basic to play sampled sounds, con- 170 REPeat loop 
vert them from other disk formats, graph a ce te 
sampled data and read a proportional ‘ana- Sib) sree we 10 ie grins Papert 
logue’ joystick in two dimensions. 210 x=CODE(kK$(1)) : y=CODE(k$(2)) 
Up till now, QL computer signals have 220 BLOCK 10,16,x,y,2 : REMark PRINT #0,x,y 
invariably been digital. This means they are Sta Ks 
considered to be at one of two levels, either ee Sn ht a 
on or off, true or false. An analogue interface 260 DEFine FuNction RBAD_adc$(address):LOCal addr$,a$ 
allows intermediate values, like shades of 270 addrS=test_ade addr%(address):IF addr%<O:RETurn ‘* 
grey. In this case, a byte of data corresponds eee gid ea nites ae eal ee 
: 7 290 2C _TO(a$ 5 9(255),5,addr%,1) 
toa linear scale of 256 voltages, from a pre 306 REMark 160 is send START+device, write from control 
set minimum to a maximum of a few volts. 310 REMark (length 1 is preset), no STOP. First 4 is 
Your programs can generate waves or read 320 ethene ies control to select mode of operation 
‘ ; ‘ 330 ark 1 wi be the first acknowledged byte count 
instruments that return varying signals. 340 REMark 178 is send START+device, read 1 acknowledged 
350 REMark byte to register - ie lose duff old sample. 
a: 360 REMark 3 will be the acknowledged read byte count 
Analogue Signals 370 REMark 156 is read 3 acknowledged bytes to buffer, 
— ; 380 REMark read one more byte to buffer without 
This is not the place to review the |2C 390 REMark acknowledge, send STOP; 255 is standard finish 
hardware; suffice it to say that its a sturdy | 400 END DEFine RAD_adc$ 
black box that connects to the Mark 2 420 REMark non-zero error code on error 
Minerva via two plugs and a ribbon cable. 430 REMark S$external 
You can connect and use several parallel or 440 DEFine FuNction WRITE£_adc%(address,x$) 
analogue interfaces at once, although the 420 LOCK) SROs WeRedges 
software only communicates with one at a eto palit or me ace a ee ee 
time. | tested the Analogue version which 480 RETUFA [2c ee het ot een 
provides four eight-bit inputs per chip, and a 490 REMark 160 is send START+device, write from control 
pair of eight-bit outputs. 500 REMark buffer (length LEN(x$)+l is preset) 
The 12C interface is controlled by a tiny ho EMA K 658 is the Anc control byte, x$ is the string 
machine-code extension, 12C_IO, which calls a REMark xo ee ‘She SUn IAG itself, 255 marks the end. 
: : 530 END DEFine WRITE adc 
new code in the Minerva rom. The !2C vec- 540 : 
tor appears in all the latest Minerva roms, 550 DEFine FuNction test adc_addr%(a) 
but you need the extra chips in the Mark 2 560 RETurn test_addrs(a,72) 
version (with a realtime clock) to communi- oh END DEFine test_ade_adur’ 
cate with other I2C devices. 590 DEFine FuNction test_addré(a,m%) 
I2C_lO lets you use the small amount of 6600 LOCal a& :REMark Simplified by SNG 
non-volatile memory in the clock chip, but 610 [FP ax"C™ OR a>"127":RETurn -4:REMark Out of range 
the protocol is complicated and error prone, | °2° IF INt(a)<*a:RETurn -15:REMark Bad parameter 
with up to four parameters and an intricate See CE ee Bel [SeBeeT Re 
: 640 RETurn -7:REMark not found 
message string. The Analogue and Parallel 650 END DEFine test _addr$ 
l2C interfaces come with extra commands 660 : 
that keep !2C_IO at arm’s length. These 670 DEFine PROCedure REPLAY (files) 
extras are written in SuperBasic by Tony eee eee eee “VLR, ENSOTE wane 
4 ; ; fs B90 a > channe a ses FLEN, TS, ,NEWCHANS 
Firshman. You can either edit and interpret 700 LOCal k$,e%,ch% : ch3=NEWCHANS : OPEN_IN #ch%,files 
eee csi or wir the equivalent 710 sampleS=INPUT'S(#ch3,FLEN(#ch$)) : CLOSE #ch% 
erated code, also supplied. 720 es=WRITH_adc%(1,k$) 
I2C_IO is tersely documented at the back PATE CUR: NR APE ERE Loe 
of the latest (green) Minerva manual, The l2C 
interfaces come with a 12 page manual that — eight bit signals to or from any parallel port. Listing one. 
explains the hardware and four new exten- WRITE_ADC% and READ_ADC$ move strings of values to or from the 


sions. READ_PAR and WRITE.PAR transfer Analogue/Digital Converters (ADCs). Characters in the string are transferred 
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GAYA AwlLA TM 

IMPLICwTs eh 

Max=327500 

DIM kS(max),hunk${20},file$(42),name$(4) 

INK 7 : INK #0,7? PAPER #0,0 

CLS #0 : CSIZE #0,2,0 

REPeak try 
BAP O 2 Che 2 COMER 2, 
PAPER 2,0, 4 
AT 0,2 PRINT " Amiga SSVX IFF sample m 
AT 1,2 PRINT " to I2C Analogue converter " 
CSITZE 2.8 
PAPER 2 
AT 5,2 : PRINT "vil.7 ° Simon N Goodwin i994" 
STRIP 0 : PRINT 
CONVERT _IFF 

END REPeat try 


DEFine PROCedure CONVERT_IFF 
LOCal ch,in%,size 
REMark Converts signed §SSVX byte IFF samples 


REMark to I12C unsigned format; uses INPUTS & ANYOPEN% 


REPeat ioop 
INPUT #0;"Enter IFF drive and file name:"\files 
TIF fileS="" : PRINT #0;"STOPPED" : STOP 
inS=ANYOPEN%(file$,1) 
TF ing>=0 : EXIT loop 
PRINT #0;"Error " & int & ", please try again." 
END REPeat loop 
HUNK name$,size 
LF INPUTS(#ina,4)-"8SVx" 
RhPeat scan 
HUNK name$,sice 
TF namegs="BODY™ 
CONVERT size i 
ELSE 
REMark Skip this hunk 
hunk$=INPUTS5(#in%,sizet(size MOD 2)) 
REMark Skip nulls 
FOR ch=LEN(hunk$) TO 2 STEP -1 
1® hunk$(ch)=CHR$(0):hunk$=hunk$(1 TO ch-1) 
END FOR ch 
TF LEN(hunkS)>1 
INK 4 : PRINT ,‘’"" & hunk$ & 7" 
INK 7 
END IF 
IF EOF( #in%) 
PRINT #0;"No sample body found." ; 
END IF 
END IF 
END REPeat scan 
RLSE 
PRINT #0;"Sanple 1s not in IFF &SVX format." 
END [f 
CLOSE #1n% 
END DEFine CONVERT LFF 


EXIT scan 


EXIT scan 


REFERENCE k$,k 

DEFine PROCedure HUNK(kS,k) 

KS=INPUTS(#1in%3,4) 

PRINT "Hunk name = " & k$; 

k=G : FOR ch=1 TO 4:k=k*256+CODE( INKEYS( #in%,-1)) 
PRINT " Hunk size = " & k 

END DEFine HUNK 


DEFine PROCedure CONVERT (bytes) 
REMark Signed bytes to unsignéd, one by one} 


o LOCal ch, k%,outs 


iF bytes>inax 
PRINT \"Fiie too long - truncating to " & max 
bytes=max 

END IF 

KS=INPUTS( #ins, bytes) 

PRINT \"Converting Sample ... "7 


0 REMark OPEN #5,scr_512x256a0x0 


FOR ch=1 TO bytes 
k3-CONE(k${ch)) 
TF kS2127 2: kS=kK4-126 : ELSE kS=KE+28 
REMark PLOT #5,i% && 511,k% 
KS (ch )-CHRS(kKS J 
END FOR ch 
REMark CLOSE #5 
PRINT "OK" 
INPUT #0;"Enter output drive and file name:"\files$ 
out3=ANYOPENS (f11e3,2) 
IF out%>=0 
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listing two] one by one over the I2C interface, at a rate of 


around 10,000 eight-bit bytes per second. 

Simplified source for WRITE_ADC% and READ 
_ADC$ appears in the first listing-The originals used 
clever SuperBasic to check parameters, but {ve 
replaced this with simpler stuff to catch most cases. 

The function TEST _ADDR% checks that an l2C 
port address is valid, using interesting bitwise oper- 
ations. The extensions are carefully designed to 
detect mistakes before they reach the I2C ports, 
and retum meaningful error-codes, 

The |2C address contains two parts in one byte. 
The bottom three bits are the unit number, while the 
other bits identify the type. Thus you can have up to 
eight interfaces of each type. When you call 
READ_ADC$ or WRITE_ADC% you can pass the 
full eight-bit address or a simple unit number 0 to 7, 
in which case the code sets the other bits to suit 
the type. The ‘bitwise or operator Il [two vertical bars] 
combines the type, M%, with the address in A 
a%=a&&8 retums zero if a is less than 8; otherwise 
it sets A% to the value of A with the bottom three 
bits cleared. 

The value -8 corresponds to 11111000 in eight- 
bit binary. The SELect on A% ensures that the 
tyoe must either be zero or match M%, which is 
78 for Analogue (ADC) ports or 56 for PAR ones. 

| put the range check values in quotes on 
line 630, so errors are unlikely even if parame- 
ter A is passed as a string, rather than a num- 
ber. The quotes ensure that the parameter is 
coerced into a string before the comparison 
takes place. For yet more reliability, use 
UNSET from DIY Toolkit Volume P to ensure 
that the parameter has a value. 


Demonstrations 


The JOYSTICK procedure contains a small 
loop that lets you move a block cursor around 
the screen with an analogue joystick. The cur 
sor is drawn in OVER -1, so that it comple- 
ments the background colour and vanishes 
when drawn a second time. Type OVER 0 to 
cancel this if subsequent PRINT commands 
give messy results. 

The demonstration runs as a loop, reading 
the inputs on port one and converting the 
resultant characters into co-ordinates for 
BLOCK. Remove the REMark from the middle 
of line 220 if you want co-ordinates displayed 
in window #0 as the block-moves. There's little 
risk of an ‘out of range’ error as new Minerva 
roms clio BLOCKs to fit any window, 

| made up a simple lead to connect the two 
potentiometers of a £5 Amstrad PC joystick to 
a pair of 12C analogue inputs. This could 
replace a mouse, as long as eight bit (MODE 
8 pixel) resolution is good enough for your 
purposes. The advantage is that results are 
repeatable. Any particular position of the stick 
will correspond to a position on the screen. 

As you move the stick the cursor jumps 
directly from place to place, in proportion to 
the movement This is far more precise than a 
switched digital joystick, like the sort that plugs 
into QL Ctr ports, which can only signal ‘up’, 
‘down'', ‘left’ or ‘right’, with no indication of pro- 
portion or speed. 

Depending on your graphics routines you 
reverse the Y co-ordinate and scale the results from 


4ou PRIN? "Saving “ & FileS & ™ .,. 
a7o PRIN fout’,k$i 
930 CLOSE #outs 
Juu PRINT "OK" 
1uU0G ELSE 
LOLO PRINT #0;"Error " & out% & ", 
L626 END IF 
PAUSE 75 
u4. END OFPine CONVERT 


file not saved 


{Ono ORFine PROCedure 5 

OCT AME FER LUPE ile 240 BAS 

igau END DEFine S 
READ_ADCS up or down. Most sticks have knobs that limitf travel. 

Often joysticks use a small part of the possible potentiomenter 
movement, so they do not retum the whole voltage range. If you 
need maximum precision, with values from O to 255 rather than 
(say) 80 to 160, you might need three resistors or a couple of pre- 
sets to set appropriate limits for the interface. If these are set too 
close together the stick will only make a difference for part of its trav- 
el, and will stick at 0 or 255 before it reaches the end-stop. 


More Precise 


PROCedure REPLAY uses the function WRITE _ADO% to play a 
sampled sound. The graph shows the wave - a sampled recording 
of ‘Rimmer’ from the BBC space-ship ‘Red Dwar? saying 
‘Marvellous’ with characteristic enthusiasm. NEWCHAN% is from 
DIY Toolkit Volume R, It retums a free channel number. 

The 32K string length limit means that each utterance is limited 
in length to about 3 seconds, but you can fire them out in rapid 
succession. There's a short pause as SuperBasic hefts each new 
string into place, but you could create near-continuous speech by 
assembling and replaying ‘phoneme’ strings. 

The sample rate is better than telephone specification but 
worse than AM radio. Speech is clear enough, while music 
sounds recognisable but a little distorted. It is important to 
use the full eight-bit range when recording samples, without 
overloading. To check this, display the sample as a graph. 

The graph uses two dots (sample levels) in each column, 
which means each width of the mode4 screen comesponds 
to about one tenth of a second, at the fixed I2C rate of 10K per sec- 
ondSamples might not be recorded at this rate - possibilities range 
from around 2,000 per second for toys to 44,100 for CDs - so they 
may sound slow or fast when replayed via I2C. Once the wave is in 
digital form you can change the length and pitch by interpolating 
extra values to slow down a fast sample, or averaging them in a 
sample that plays too slowly. 

The two traces follow the 'M' sound at the beginning of the word. 
The middle trace was drawn first The level is limited by the louder 
‘ah’ sound that comes later. The whole sample uses 


The colour must be specified each time; move the IF test 
on line 230 to 295 if you want the same colours with 
BLOCK as PLOT. 

Eight-bit samples are widely available from PD libraries; 
the ‘Rimmer sample came from an Amiga cover-disk. 
* 1Sample formats vary; some are signed values from -128 
to 127, others (like the 12C ones) are unsigned bytes, and 
most are packed or padded in some way. 


Decoders 


QL users have easy access to these files via the PD 
Amiga Qdos QL_HANDLER, DiscOver and similar utilities, so 
I've written programs to decode Amiga IFF (Interchange File 
Format) ‘8SVX' and some Microsoft WAV files, Many utilities 
on Mac, PC and other computers support these formats. 

The second listing is my IFF file Converter, written in 
SuperBasic. You need the IFF file on a QL drive first; the pro- 
gram converts that sample into the l2C format used by 
REPLAY and WRITE_ADC%. 

The Turbo/DIYT extension INPUTS is used in REPLAY and 
the IFF Converter to read a sequence of characters from a 
file in one go. If you lack INPUT$ and are in no hury you 
could build a string with successive calls to INKEY$. FLEN is 
in Toolkit 2, PD Toolkit, Thors and most disk roms. 

IFF files consist of a sequence of ‘hunks’ with four 
character names and 32 bit sizes at the start of each. 
CONVERT_IFF looks for the 8SVX block that contains the sample, 
skipping or reporting others en route. IFF supports graphics, text 
and animations as well as sounds; Ergon’s Open World utility cor- 
verts IFF graphics to QL modes, 

PROCedure CONVERT changes each byte from signed to 
unsigned format This conversion is accelerated amazingly much 
by Turbo, which is why Ive supplied TF Services with a compiled 
version for |2C users. The initial DATALAREA and IMPLICIT% direc- 
tives instruct the Turbo compiler. Remove the REMs on lines 840, 
880 and 910 to see a rough graph as the sample is converted. 

There's lots more to be done with the Analogue interface and a 
litle SuperBasic. You could keep tabs on your your environment 
with temperature and light sensors, ranging from old-fashioned 
thenmistors and light-dependent resistors to the latest active sen- 
sors. You could control a robot, record speech messages for digital 
replay, in a QL-controlled answer-phone, or synthesise waves of 
sound or pattems of light with simple formulae. 

Alas, I2C is not for everyone. You need the Mark 2 Minerva, and a 

litle knowedge of electricity, to make use of any I2C interface. The 

programming is simple and exciting, because these ports let 
your QL interact with the intricate world outside, where a little 
SuperBasic can go a long way. Listing three. 


about 17K 

PROCedure GRAPH plots the wave. The PUT #3\0 
in line 150 is only needed if you want to re-plot without 
re-opening the file. Lines 170 and 180 use BLOCK effi- 
ciently to plot a fine millisecond grid. Change the limit 
of the FOR T loop if you want more of the sample over 
laid on each screen. Lines 220 and 230 ensure that 
each trace appears in a new colour, starting with green, 
then white, then red, and back to green. Pixels are lit by 
the DIY Toolkit PLOT function, from graphics Volume G. 
lf you dont mind a slower, flickering display you could 
replace PLOT with a call to BLOCK like this: 

270 BLOCK #4,1,1,], CODE(k&(i)),colour 

Sinclairs BLOCK routine is clumsy if you're try- 
ing to light individual pixels, but at least it's not as 
eccentric as POINT. In QL Modeé and Thor 
Mode12 you need to change the width (second 
parameter to 2 or the dot will not appear. 

Flicker appears because each BLOCK is drawn 
as a short line and clipped on either side to fit. 


DEFine PROCedure GRAPH 

REMark Uses INPUTS and PLOT (DIY Toolkit) 

REMark + PUT and FLEN (PD/SuperToolkit) 

MODE 4 : red=2 : green=4 

OPEN_IN #3,"flpl_marvelous_QL" 

PUT #3\0 

OPEN #4,“scr_512x256a0x0" 

FOR y=8 TO 255 STEP 10 : 

FOR x=6 TO 511 STEP 10 : 

colour=red 

FOR t=1 TO 2 

REMark For more scans use T=1 TO FLEN(#3) DIV 1024 
colour=colour+red : INK #4,colour 

colour=0 


BLOCK #4,512,1,0,y,red,0 
BLOCK #4,1,256,x,0,red,0 


IF colour>green : 
kK$=INPUTS(#3,1024) 
FOR i=l TO 1023 STEP 2 
j=i DIV 2 
PLOT #4,j,CODE(k$(i)) 
PLOT #4,j,CODE(kS$(iti)) 
END FOR i 
END FOR t 
CLOSE #4 
CLOSE #3 
END DEFine GRAPH 
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Miracle Pian to Take On Software Too 


After a delay since last November, while a number of small bugs were sorted 
out, Miracle Systems have made a lot of progress with software for their PC- 
colonising QL card QXL, and are hoping to have a new release for users by the 
time this news item is published, 

Said Stuart Honeyball: “The disk formatting software should be fixed and the 
compatibility of the 8-bit slot have been sorted out. We have had one release from 
Tony (Tebby, QL operating system author in the meantime which we didn't issue 
because there were a few things that needed some more work. They were mosily 
fairly minor.” The SuperBasic is also expected to be ready before too long, but 
there is no date yet. 

Stuart sees Miracle moving more and more into producing their own software 
as time goes on. “We need to move the QL into multi-processing”, says Stuart, 
laughing, “| have seen the future of the QL and it is multi-processing!" Make no 
doubt about it, he’s in earnest. 

In the meanwhile, Miracle are also working on a new version of the Gold Card. 
True to thelr regular policy, Stuart did not want to say more about that until he can 
give a clear schedule for it, and asked us to ask him again in two or three weeks. 
Rumour, though, is whispering that the new version will be even faster than the 
present one. 

Miracle’s show calendar after February includes the ever-popular Quanta Bristol 
Workshop on 27th March {contact Quanta), the Quanta AGM on 23/24th April in 
Tynemouth, Northumberland, and another visit to Newport, Rhode Island, USA, for 
May 14th, where they hope to show the first version of their SCSI card, Miracle 
have a full diary for January and February, including Edinburgh on 12th and 
Bielefeld on 19th (See QL Scene). They came back from Manchester/Blackrod 
disappointed by attendance - “not enough publicity’, said Stuart, and QL World 


can only agree. 


NEW PUBLIC DOMAIN COMMS 


SJPD Software have now added to their disk collection C68 Compiler V4.01 from Dave 
Walker, plus two new communications packages from Jonathan Hudson: QeM Release 
400 and QTPI (Disks SUS 44 and 77). QeM 4.00 offers full ANS! colour graphics mode, 
VT52 and VT100 terminal emulation, and it also supports Tandata’s QConnect and Hayes 
Compatible Modems, along with a host of other features. QTPI runs under the Pointer 
Environment for those who already have the Pointer Environment, and offers all the fea- 
tures of QeM, plus others. 

Also new to the collection is QLfax and ATP Offline Reader (SUS 74), both in the Beta 
Test versions at the time of writing. Steve warns: “They are in their infancy, but have 
reached a stage where they are almost stable (| hopel).” Also new is the demo version of 
LineDesign, which is also a Pointer Environment program, and has all the features of the 
general release of LineDesign, except, of course, that you cannot save and print with it 

In the SJPD list, there is now Zip and Unzip 3.0 {file compressor), QSpread Demo 
(Pointer Environment spreadsheet demo), Archive to Pipedream Conversion Program (for 
Cambridge Z88 users), Deskjet Envelope Printer (for Deskjet 500) and Indexer Demo, 

Steve's well-known literary collection now also features works by Jane Austen, Bram 
“Dracula” Stoker, Mary “Frankenstein” Shelley, Emily Bronte, Cervantes, Charles Darwin 
and Chaucer. Who says computer buffs don't read? 

All disks are £1.75 inclusive of media and return postage, or £1 if user supplies disk 
and return postage. 

SJPD also supplies second-user QL hardware and software, and back issues of QL 
magazines. 

In particular Demo versions of commercial software are a very good deal if you want to 
check them out before deciding if they might add to your QL life. Steve's disk-catalogue is 
continually updated and contains some PD software too. It is free to anyone who sends a 
disk, return postage and a self-addressed label, Program versions are continually updat- 
ed. 

SJPD are at 36 Eldwick St. Burnley, Lancs BB10 3DZ. Tel. 0282 451854. 


Famous Meters 
Hit 70 Years 


Electronics and electrical 
experts will be pleased to hear 
that the well-known Avometer, 
the original multimeter, has just 
celebrated its 70th birthday. 
That's older than many of us. 
The “big black box” has been 
around since 1923, and is still 
going strong. 

How many computers do 
you think will be able to say 
that in the year 2050? 

lf you think that you can per- 
suade the family to buy you a 
new one for Christmas {or even 
next Christmas), ask for infor 
mation from Avo International, 
Archcliffe Road, Dover, Kent 
CT17 9EN, UK. Tel. 0304 
202620. 


Jochen Merz has told us 
that the Pointer Envir- 
onment is indeed sup- 
plied with their new multi- 
tasking chess program 
Black Knight. 
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Beginners’ 
Machine Code 


In part 8, Alan Bridewell sets the code to trace and manipulate pixels. 


t the start of this series | said 


that | would illustrate all the 3 ERR HERDER EHR EEN NRE ERR RRR HERRERA RARE HK ERK RRR 
ideas with routines that ; OPEN A CON CHANNEL 
would produce something EH REHM RE RER EHR HAE EHH EH RHEE RH Re 
on the screen. Initially, this only need- OPEN LEA-L CON,A1 «;-_:« GON TABLE POINTER iN 4, 
ed a knowledge of the addresses of MOVEA.W $C, A2 3 UT_CON VECTOR IN Fu 
the screen ram, without any under- ects a ig a ee 
standing of how it was organised. st WHEE |aGLIL: 4 ce ae 
Later, it was necessary to realise that 
the screen ram was organised in 5 a eee nn eee tenes ap meee eegeee 
words (pairs of adjacent bytes) which : <ssi sane Waals au Wick aaa 4d uae easiness cna o aieeialeaiod SRE CR RRR EE 


held the data for a set of four or eight i 
»PTEKT LEA.L ID,Ai 


: : 3 CHANNEL ID STORE IN Ai 
consecutive pixels, depending on MOVEA.. (AL),AG 5 CHANNEL ID IN AO 
whether the QL is in mode8 or LEA.L TEXT,AL 3 BASE UF TEXT IN At 
moded4. MOVEA.W = -$D0,A2 3; UT_MTEXT VECTOR iN AL 
There is normally no need to sas ‘Az} a PRINT TERT 
understand more than this because : ed ie hh ih hee hee eee ee Pe eee ee eo ee eo 
the complicated job of drawing lines 3 FETCH A LINE OF CHARACTERS 
or printing text on the screen is done ‘itt eee eee eee eee eet ee te eo oo ee Se ee ee 
by Qdos routines, which we can use FETCH LEA.L 1D,A1 3 CHANNEL ID STORE IN 41 
in our programs without having to MOVEA.L (A1),AO 3 CHANNEL ID IN AO 
know what they are or how they actu- LEA.L BUFFER,AI ; BUFFER ADDRESS IN 4st 
thr weyie MOVEQ #2,D0 3 #IO_FLINE IN DO 
ally MOVE. W #BUFLEN,D2 3 BUFFER LENGTH IN D2 
MOVEO #-1,D3 9; INFINITE TIMEOUT 
TRAP a3 
= = etn ; (HIS LEAVES THE LENGTH OF THE STRING (INCLUDING THE LF) IN ui- 
Pixel Printing : (Ff WE WANT TG USE THIS STRING AS A CHANNEL NAME, WE NEED THe © isu 
; THE STRING (WITHOUT THE LF) JUST BEFORE THE STRING ITSELF (Wriif.r! 
However, there is one type of prob- |: Stomeb IN ne surrErs api- 2 
lem where the programmer really " es 
needs to know exactly how the infor- SUBO.L #1,D1 ; SUBTRACT 1 FRUM Di 
mation for the colour of each pixel is : AND PUT iHE RESULT IN BUFPOS, JUST IN FRONT GF BUFFER 
stored. (This is true regardless of the oe LEA.L BUFPOS,AO ; LOAD BUFPOS IN AO 
language being used, including MOVE.W =I, (AO) sg: PUT CONTENTS GF 07 IN mre 
SuperBasic,) i 
There are programs where the pro 4 REE ERE EERE HRHEHER HHH RHR RA HR 
FF ; OPEN THE FILE 
grammer needs to find the colours Pee eee eee ese eee cies t eri te tee e ee eet eee tere cee rere ee eer eee ee eo 
of Individual pixels on the screen. ; 
: LEA.L BUFPOS,AO ; BUFPOS IN 40 
The classic example is the screen MOVEQ #i,DS ; OPEN AND OLD, SHARED FiLi 
dump routine for a printer. Fora MOVEQ #-1,0i 3 71 IN D1 MEANS ‘THIS vu 
colour printer, the program must first MOVER #laDo 5) WIC_OREN “IN De 
; : TRAP #2 
identify the pixel colour, before send- TST.L DG ; IS THERE AN ERROR? 
ing data to the printer to print a dot of BEQ.S GOT_FILE 3 IF NOT, CONTINUE... 
that colour. For a monochrome print- ; 
er the program must send data for a : 
pattern of dots to produce a suitable MOVEA.W $CA,AZ = 5 ERRO IN AZ 
grey tone for each colour. | am not JSR (a2) 3 PRINT ERROR MESSAGE 1N # 


. JMF PTEXT 3; REPEAT PROMPT . 
really concemed here with what the 


program does with the data, so } SIGRE FILE CHANNEL I.D WHICH IS NOW IN AO 
much as how it gets that data in the 5 


3 
-oUT_FILE LEA.L FILE,AL 3 ADDRESS OF FILE iN 4! 


a ag we (iiss MOVEA.L AO,(AL) 3 CONTENTS OF AU INTG ADORESS in AL 
am not going to use this to pro- 3 
duce a fans ba routine. Firstly, | 5 NOW LOAD THE FILE INTO THE SCREEN RAM 
said | would make the program do MOVE. L #$9000,D2 ; FILE LENGTH IN D2 
something ON the screen. Secondly, MOVEA.L #$20000,A1 ; LOAD ADDRESS IN Ai 
; ; ira ai MOVE #-1,D2 7 INFINITE TIMEGUT 
end einen, Ge wane hie MOVEA-L-FILE,AG 5 FILE CHANNEL I.F IN At 
, MOVEQ #$48,D0 ; FS_LOAD IN DO 
printer. However, if you do have a TRAP #5 
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printer, and if you understand this article, 
and understand your printer manual, you 
should be able to have a go at produc- 
ing a screen dump routine of your own. 


Screen Ram 


So how exactly is the QL screen ram 
organised? 

Each row of pixels on the screen 
requires 128 consecutive bytes (64 con- 
secutive words) to store the data. This is 
true regardless of whether we are using 
mode4 or mode8. In mode4, each word 
holds the data for eight consecutive pix- 
els, making 512 pixels in a row. In mode 
eight, each word holds the data for only 
four consecutive pixels, making 256 pix- 
els in a row. Since each mode8 pixel is 
twice as wide as a modeé4 pixel, 512 
mode4 pixels and 256 mode8 pixels 
occupy the same width of screen. 

The difference in the number of pixels 
that each word can hold arises as} will 
describe, 

In mode4, there are only four states 
each pixel can be: black, red, green or 
white. Data involving four possible val- 
ues can be held by two bits (binary dig- 
its), because they can have four combi- 
nations, 00, 01, 10 and 11. Now in a 
word (two bytes) there are eight pairs of 
bits, so a word can hold the data for 
eight pixels, 

In mode8, there are sixteen states 
each pixel can be: one of eight colours 
in two possible states, flashing or not 
flashing, making sixteen states in all. | 
will leave you to work out that sixteen 
possible values requires four bits, and 
as a word contains four lots of four bits, 
it can only hold data for four pixels. The 
entire screen contains 256 rows of pix- 
els in either mode, so requires 256 times 
128 bytes of ram, which comes to 
32768 bytes. 


Odds and Evens 


Each word in the ram consists of an 
even address and the following odd 
address. The total number held by the 
word is worked out from the numbers in 
the two bytes as follows. The number in 
the even bytes is multiplied by 256 and 
added to the number in the odd byte. 
This sounds complicated until you see 
how it works out in binary numbers. Also, 
since it is the individual bits which carry 
the data, it is much clearer why a partic- 
ular value has the effect it has iwhen we 
use binary numbers, 

256 in decimal is 100000000 in binary, 
and you multiply a binary number by 
100000000 by adding eight zeroes, For 
example, if the even bytes holds 
11110000 and the odd byte holds 
1010101010, the word will hold 
1111000010101010 because: 


(11110000 x 100000000) + 10101010 = 


: 
FRE RRR REE RRR EEE RR EERE AREER ERE EERE ee 
3 CONVERT SCREEN TO MONOCHROME 

5 EERE R ERR ERE RE RRA EE HER EERE EERE EERE E EERE EKER ERR HEHE RRA KERR EE 


3 

MOVEA.L 
MOVE. W 

MOVE .w 
MOVE .W 

MOVE 


#5FF D5 
#S3F,DS 
(A1) D1 
$#7,D2 


. ROWLOOP 
-BwURDLUGP 


#$9080,D3 


-BITLOOP D3,D4 
D1,D4 
BLACK 
bD3,D4 
WHITE 
D3,D4 
D1i,D4 
#SFF DS 
RED 
GREEN 
#1,D3 


D2,BITLOCP ; 


#2,A1 


#20000, 


Al ; ADDRESS IN Al 

3; ROW COUNTER 

; WORD COUNTER (iN ROW) 

3 CONTENTS into D1 

3 8 BITS IN BYTE 

3} TEST BITS 

3 COPY TEST BITS 

3 COMPARE WITH Di 

3 IF ZERO, THEN BLACK 

3 IS IT THE SAME AS TEST BI1S? 
3 IF SO, THEN WHITE 

3 RECOPY TEST BITS 

; COMPARE WITH Di 

; WHICH BIT IS SET? 

; IF LSB BIT THEN RED 

3 ELSE GREEN 

; NEXT BITS 

AND LOOP 

; INCREMENT TO NEXT WORD 


Dé,WORDLOGP ; NEXT SCREEN WORD 


YORIGIN, 


#1, (AB) 


XDRIGIN, 


#0, (AS) 


DS,ROWLOGP ; 
XORIGIN, 


#0, (AS) 


YORIGIN, 


#0, (A3) 


AS 

3 INCREMENT YORIGIN 
AS 

3; RESET XDRIGIN 
NEXT ROW 
AS 

; RESET XORIGIN 
As 

5 RESET YORIGIN 


BR RE RE AH IEE IE IEE EHEC IE TEE FETE ETE IE TEE TE FETE EE ETE TFET TE EIT EE TEE TE EEE 
CLOSE THE CHANNELS 
RF IIE ETT IE JE ETE TE FETE FETE TE JE ee EE JE HE 6 2 EAE RHEE EE ei ee 


LEA.L 
MOVEA.L 
MOVEO 
TRAP 
LEA.L 
MOVEA.L 
MOVEO 
TRAP 
RTS 


FILE,A1 
(A1) ,AO 
#2,D0 
#2 
1D,A1 
(AL) ,AO 
#2,D0 
#2 


3; ADDRESS OF FILE CHANNEL 1!.D. 
; INTO AO 

; IO_CLOSE IN DO 

3 CLOSE FILE 

; ADDRESS OF CONSOLE CHANKEL £.D. 
3 INTO AO 

; 10_CLOSE IN DO 

3 CLOSE CONSOLE 

j RETURN TO SUPERBASIC 


tee eee eet ee ee ee ee ee 2 re Wt tel ie be ae 


PRIN 


BLULK SUBRUU) 1NE 


i let Reed Ahh he ee ee ee ee Le ee ee RHR ER Ee ee 


. BLACK MOVEM. L 
MOVEL 


BRA 


#0,D1 
DRAW 
- GREEN MOVEM.L 
MOVE. B 
BRA 


#4,D1 
DRAW 


+RED 


MOVEM.L 
MOVE .& 
BRA 


#224,Di 
DRAW 


1111000000000000 + 10101010 = 
1111000010101010 


In other words, we get the entire 
number by simply putting the two 
numbers together, even before odd. 

How are the colours represented by 
this? Let us look at modeé first, 

The even byte gives the greens and 
the odd byte gives the reds. Each bit 
read from left to right gives the row of 8 
pixels, again, from left to right. A 1 
means the colour is set, and a 0 
means it is cleared. If both are set we 
get white. If neither are set we get 
black. It is clearer what is going on if 
we put the bytes one under the other, 
so the two bits affecting the same pixel 
are together. So in the example above 
we get: 


AQ-A7 /DO-D7 ,—(A7) 


A0-A7/DO-D? ,-(A7) 


3 SAVE REGISTERS 
5 BLACK 


3; SAVE REGISTERS 
3 GREEN 


AO-A7/DG--D7,—-(A7) 3; SAVE REGISTERS 


3; RED 


EVEN (GREEN) 11110000 
ODD (RED) 10101010 


The first pair of bits are both set, so 
we get white. In the next pair, only the 
even bit is set, so we get green. 
Following across all the bits we can 
see that this word will give a row of 
pixels: 


WHITE, GREEN, WHITE, GREEN, RED, 
BLACK, RED, BLACK. 


Mode8 is more complicated. The 
even byte gives greens and flashings 
with pairs of adjacent bits. The odd 
byte gives reds and blues with pairs of 
adjacent bits. So taking the same 
example again: 
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MOVEM.L 
MOVE.B #212,D1 
LEA.L 
MOVE.L 
LEA.L 
MOVED 
MOVED 
TRAP 
LEA.L 
ADD.W 
MOVEM.L 
BRA 


#1, (AZ) 


RET 


AO-A7/DO-D7,-(A7) 


SAVE REGISTERS 
3 WHITE 


3 CHANNEL 1D IN AC 
3; BLOCK BASE IN Ai 


SD_FILL IN DO 
3 INFINITE TIMEOUT! 


XORIGIN,AS 


3 INCREMENT XORIGIN 


(A7)+,A0-A7/DO-D7 3; RESTORE RESISILRS 


3 RETURN TO MAIN ROUT INL 


i EE EE He i J EE HE HE EE HE HE HE REE REE RHEE ERR R ARR 


3 PARAMETERS, DATA AND DATA SPACES 
EAE RE EE EE IE IE EE EH RHEE EEE EEE EERE HER REE R RHR RHR REHASH 


> SPACE RESERVED FOR CONSOLE CHANNEL PARAMETERS 


» CON £0000 
$0007 
$0200 
$0100° 
$0000 
$0000 


5 BORDER COLOUR & W1iTi! 
3 PAPER & INK COLU)UR 

3 WIDTH 

3 HETGHT 

3 X ORIGIN 

5 Y ORIGIN 


7 SPACE RESERVED FOR CONSOLE CHANNEL I-D. 


1D DC.L 
3 

7 SPACE REGRVED FOR BLOCK DEFINITION 
» BLOCK DC. WwW 1 
oC.W 1 
DC. Ww rs) 
DC.W o 


»*XORLGIN 
-YORTGIN 


; SPACE RESERVED FOR FILE CHANNEL I.D. 
; 

«FILE be. 
; TEX! FO BE WITTEN IN THE WINDOW 


»~ TEXT DC.W 


oC.B 


SOE 


«BUFLEN 160 
-BUFPOS 


.» BURFER 


$00000000 ; 


BOOOOOLOO 5 


“FILE NAME ? * 


CONSOLE CHANNEL ID 


1 PIKEL WIDE 
41 PIXELS HIGH 

; X ORIGIN OF BLOCK 
Y GRIGIN OF BLUCK 


FILE CHANNEL i.D. 


3 NUMBER DF CHARALC FE: 
3 CHARACTERS 


5 LENGTH OF ENFUT Mut bY 


, 
BME TE FETE REE eH FER TE HE FE TE HE TE TE HE TEE aE FEE TE TEBE HE DE HE HE EE DEE FE SE HE HE EE EE EE it RH ee 


EVEN (GREEN + FLASH) 11110000 
ODD (RED + BLUE) 10101010 


The first bit in the even byte is set, 
showing green, and the first bit in the 
odd byte is set, showing red. Green 
and red together give yellow. The sec- 
ond bit of the odd byte is also set, 
showing flashing. So the left pixel is yel- 
low flashing. Following across the pairs 
of adjacent bits in each byte we can 
see that this word will give a row of pix- 
els: 


YELLOW(FLASHING), 
YELLOW(FLASHING), RED, RED 


This all looks a bit daunting at first, 
but a bit of familiarity will soon make it 
seem fairly straightforward. Probably the 


best thing to do at this stage is to try 
poking some values in the screen 
ram, and try to work out why it pro- 
duced the effect it did. If you go back 
to the listings in part 5 of this series, 
you will find them quite useful for this 
exercise. 


ANDing 


Knowing how your QL converts ram 
data into pixels is al! very well, but it is 
no use unless your program can 
determine whether individual bits 
have been set, and then take appro- 
priate action. There are several ways 
of doing this, but a couple of instruc- 
tions are probably all you need for 
most applications. 
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In part 5 of this series we covered the 
AND instruction. This carries out a bit by 
bit comparison of two numbers (which 
can be bytes, word or longword in size), 
and gives a 1 if and only if both bits are 
1. For example, if we AND the binary 
numbers 10101010 and 10000000, we 
get 10000000, because the left bit of 
both numbers is set, and is the only one 
set 

This gives us a mechanism for finding 
out if a particular bit of a number is set, 
We simply AND it with another number 
with only that bit already set. If the result 
has that bit set, we know the original 
number had that bit set set. Using this 
we can easily analyse each bit in turn. 

We are not restricted to analysing one 
bit at a time either. For instance, sup- 
pose we are working in moded4. If we 
AND a word in the screenramwith the 
ward 10000001000000 we can find out 
if the first bit in both the even and odd 
bytes are set If the result is all zeros we 
know that both bits are clear, and the 
left pixel of the word is black. If the result 
is not zero, further analysis will tell us if it 
is green, red or white. 

Although we could make do with this 
alone, to analyse a whole word in 
mode4 would require eight repetitions 
of almost identical code, with only the 
test word being changed. Our program 
could soon become very long! We 
could use the same code over again if 
we had an easy way of altering the test 
word to test for consecutive bits in turn 
automatically. To do this we can use 
one of a set of instructions called shifts 
and rotates. 


RORing 


| am only going to deal with one of 
these, the one which is useful in this 
particular problem. The instruction is 
ROR, which stands for “rotate bits to the 
right”. In this instruction, the bits of the 
number form a loop with the carry bit in 
the status register. When the instruction 
is carried out, all the bits in the number 
move one place to the right. The right 
hand bit goes into the carry bit of the 
status register, and the contents of the 
status register goes into the left hand bit 
of the number. Repetition of this instruc- 
tion will eventually bring the original 
number back into place, hence the term 
“rotate”. 

What makes the ROR instruction use- 
ful here is this. lf we ROR the test word 
between each AND instruction, we can 
use the same AND instruction over 
again in a icop to test each bit in turn, 
instead of having long repetitive code 
with just one line slightly altered. 

In order to demonstrate these ideas, | 
have produced Listing one, a routine 
which will load a screen from a file, and 
then convert it from colour to mono- 
chrome in mode4. When | started exper- 
imenting with this routine, | intended to 


Fn 


me aay 


Z2=RESPR (S12) 


LBYTES flpi Lasting! code,z 


OPEN#3,con_5S12x256a0x0 
REPeat |] oop 
CLS#S 


PRINT#3."Process a screen file? (¥/N)D" 


a=CODE t INKEYVS (#3,—-1)> 
1 SELect ON a 

= 69,t21:CALL z 

= 78,110: STOP 

END SELect 

PAUSE -1 

END REPeat loop 


convert red and green into 
dark and light grey, leaving 
black and white the same. 
However, the stipple combina- 
tions for these tend to produce 
a stripey effect, which is not 
very good. In the end, | opted 
for converting red into a 
green/black chequered stipple, 
and white into a green/white 
chequered stipple, leaving 
black and green the same. 
This produces an acceptable 
black and green monchrome 
effect. After you have typed in 
the routine, it is easy to alter 
these to see if they get better. 
The listing is quite long, but 
most of it involves a recycling 
of ideas used previously, so will 
not require much explanation. 
We start by opening a con- 
sole channel to input the 
screen file name. The window 
occuples the entire screen, so 
that it can also be used to put 
new pixels on the screen. Next, 
we write a prompt in the win- 
dow asking for the name of the 
screen file. A line of characters 
is fetched from the keyboard 
and stored in a buffer. An 
attempt is then made to open 
a file, using this string as a file 
name (including drive). If this is 
unsuccessful for any reason, 
an error message is printed, 
and the prompt for a file name 
is repeated. If this is successful, 
the file is opened, and the con- 
tents loaded into the screen, 


The Procedure 


This has ali been covered in 
previous parts of this series. 
The spaces required for para- 
meters, buffers, text and chan- 
nel IDs are towards the end of 
the listing. 

Having loaded our screen 
file, we now convert it to mono- 
chrome, which is the main part 
of the program. It is probably 
best to read this part while fol- 
lowing the listing. 


First we move the start address 
of the screenram($20000) into 
register Al, and move $FF into 
register D5 as a row counter. 
Neither of these need resetting 
during the routine, so they are 
outside the main loop. The main 
loop, called ROWLOOP starts 
with moving $3F into register D6 
as a counter for the words in the 
row. This will need resetting each 
time we start to process a new 
row, which is why it is in that 
position. The first embedded 
loop, called WORDLOOP, starts 
by moving the contents of the word whose address 
is in Al, into register D1, ready for processing. This 
processing involves looping through the eight bits in 
the even and odd addresses of the word together, so 
we move 7 into register D2 to act as a bit counter, 

Next, we move the test word (the one we are going 
to AND with the data) into D3. As we are going to 
start by testing the far right bit in the two bytes, we 
move the binary number 1000000010000000, which 
is the same as the 
hex number $8080. 
Your assembler 


Lastiny < 


If the pixel was neither black 
nor white, it means that either 
the bit in the even or the odd 
address was set, but not both 
or neither. To find out which, 
we need to repeat the first two 
lines of BITLOOP to test the 
two bits again. The result of this 
test is compared with $FF, 


Red and Green 


Now if the pixel is red, then 
the AND will result in a number 
less than SFF, and the compar- 
ison will result in a minus num- 
ber (remember, CMP involves 
subtracting). In this case we 
branch to process a red pixel. 

If each of these does not 
result in a branch, the pixel 
must have been green (the 
only other possibility), so we 


may allow you to 100 ReMark Sinclair QL World HEX LOADER v 3 


use binary notation | 550 


310 ReEMark by Marcus Jeffery & Simon N Goodwin 


in the listing, iN | i20 cus: RESTORE :READ Space: start=RESPR (space) 
which case do SO, 140 PRINT "Loading Hex..."2HEX_LUAD start 


because it makes it 150 JNPUT "Save to file..." 
i6G SBYTES #%,start,byte:STOP 


much clearer why | j3¢ 


that number is | t80 DEFine Function DECIMAL tx) 


being used, 190 RETurn CUDE (h#(x))-4B-7e (hd (x) "GY 


200 END DEFine DECIMAL 
We now come to | sy, ; 


the inner 
called BITLOOP. 230 byte=0: checksum=0 
Becauase the AND 240 REPeat joad_hex_digits 
; 4 : 250 

instruction might | zeo 
alter the test word, | 27° IF LENths) Mop 2 


READ he 


lOOp, | 220 DEFine PROCedure HEX LOAD start) 


[F hS="*"3 EXIT ‘pad hex _digits 


280 PRINT "Odd number of hex digits in: “Shs 


we have to make | Sy, STOP 
another copy of itto |] 300 ~~ END iF 
do the actual test- | 32° 


FOR b=1 TO LEN(h$) STEP 2 


320 RO=DEC IMAL (b) :ib=DECIMAL (b+1) 


ing, SO we start the | 335 
loop by moving the | 34 
contents of register | 35° 
D3 into register D4, | 36° 


END IF 


IF hb<O OR hb>1S OR 1b<O OR 1b>15 
PRINT "ILl@gel hex digit int “sh#:STOP 


PUKE start+byte,léenbtlh 


370 checksum=checksum+Léshb+] b 


which will actually | seo byte=byte-+1 


be used in the test | 3%¢ END FDR b 
ing 460 END REPwat loed hen digits 
4 405 PRINT checksum: STOP 


We now AND the | 4:0 reap checn 
word in D1 (which 420 IF check? *checksum 


{ 430 PR “Ch - 2» o 
contains the con- Pe INT "Checksum incorrect. Recheck data. ":STOF 


END IF 


tents of Our screen- 450 PRINT "Checksum correct. Data entered at: "start 


ramaddress) with 460 END DEFine HEX_LOAD 
ayo : 


the test word in D4, | ga6 


DATA “43FA0136": REMark 


zero, the pixel is DATA "34780006": REMark 
black, and we DATA "4E92": REMark 
branch to an DATA "43FA0138"2 REMark 
DATA "2288": REMar k 
me DATA "43FA0132":REMark .PTEXT 
’ 170 DATA "2051": REMar k 
If the pixel was > DATA "“43FA013C":REMark 
; DATA “347800D0": REMark 
white, the test word DATA “4592";REMar i 
would be unaltered. DATA "43FA01 22": REMark 
We compare it with DATA "2051":REMark 
F DATA "42F 40130": REMark 
oe a a DATA “7002":REMark 
salt Ra DATA "34500064": REMar k 
: ATA "JOFFE": REMark 
to nAnceke a white DATA "4F423"; REMark 
) DATA "5381" :REMark 
pixel. DATA “41FA012A":REMark 


REMark Space requirements for the machine code 


leaving the result in | 490 vata 356 
D4, If the result is : 


CON,AtL 
$06,462 
(A2) 
ID,At 
AG, (Al) 
ID, AL 
MOVEA.L (AL), AO 
LEA TEXT AL 
MOVER. W #DG,A2 
JSR (AZ) 
LEA ID,Al 
MOVEA.L (ALD AO 
LEA BUFFER ,AL 
MOVEG #$2,D0 
MOVE.W #BUFLEN, D2 
. MOVEO 
TRAP 
SUBQ.L 
LEA BUFFOS , Av 
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branch to process a green pixel. Whichever 


pixel colour we had, the routine will retum us | 700 oan eee oan ReMark ‘aay a as 
to address RET after the pixel_has been 720 DATA "7601":REMark MOVER #1455 
processed. At this point we ROR the word 730 DATA "72FF":REMark MOVEQ #-1,D1 
containing the test bits. This means that next ie tee beigiieherep ign sete —— ee 
time we loop round, we shall be testing the 760 DATA "4AG0":REMark TST. Do 
next bits to the right, which will give us the see BEQ.S GOT _FILE 
; 7 730 DATA "™ Pf “yREMark MOVEA.W #CA,AZ 
next pixel to the right So we are now ready 790 DATA "“4E92":REMark JSR (AZ) 
to decrement the bit counter and branch g00 DATA “4EFAFFBC":REMark IMP PTEXT 
back to the start of the BITLOOP with a 810 DATA "43FA00F8":REMark LEA FILE,Al 
DBRA instruction. 820 DATA “2280":;REMark MOVE.L AG, (Al?) 
5 830 DATA "243COG008000": REMark MOVE. #$5000,D- 
After we have looped through all the bits, 840 DATA "227000020000" : REMark MOVEA.L #$20000, 41 
we leave BITLOOP, and move on to the next BEO DATA “74FF":REMark MOVEG #-1,D3 
word. So we ADD 2 to register A1 to incre- a ee re BY Es eae 
ment the address to the next screen word. | Sao pata “aras“cREMerck Se oo 
We can then decrement the word counter, 90 DATA "227000020000": REMar k MOVEA.L #$20000,A1 
and loop back to the start of WORDLOOP, | 700 Bara anion ert gowooe oven sear c 
i ark . = SSF, 
After we have looped through all the 920 DATA "3211":REMark .WORDLOOP MOVE. w (A1) (D1 
words in the row, we leave WORDLOOP, 930 DATA "7407":REMark MOVED #7 ,D2 
and move on to the next row. 940 DATA "36308080": REMar k MOVE .W #$8080 , D3 
. ‘ H 950 DATA “3803":REMark -BITLOGP MOVE.W D3,D4 
_ Now processing the pixels involves draw- 940 DATA “C541";REMark AND. Wi D1_DA 
ing a 1 by 1 block in each pixel position. 970 DATA "6700002": REMark BEG 
When we start a new row, we have to set the Tee Oe el cae exo — 
n 3 ar 
coordinates (XORIGIN and YORIGIN) to the Sb BETS = shos* saber PEE Bi 
start of the next row. This means increment- 1010 DATA °C841":REMark AND. W 
ing YORIGIN for a new row, and making ee CMPI.W 
XORIGIN zero for the left of the screen. This | [570 DATA Tepooooeels Remerk be 
done, we can decrement the row counter, LORS VATA “EISB": REMar k -RET Rut. 
and loop back to the start of ROWLOOP. 4050 LATA "SICAFFDE" :REMar k DBRA p2 BIT: 
1070 DATA "D3FCOO0O00G2": REMar k ADDDA. iL #2,A1 
1660 DATA “SICEFFCC":REMark DBRA Dé , WORDLE 
a 1090 DATA "“47FH00946":REMark LEA YORIGIN, A, 
Tidying Up 1100 DATA “OS530001":REMark ADDI.W #1, (AR) 
120 DATA “47FA00BC": REMark LEA wO AL te 
tt h m i 1120 DATA "Z36BCOOO0O":REMark MOVE .W =. . 
After we have ooped through all the rows 1130 DATA “SiCDFFB4":REMark DERA DS, ROWLOW? 
(processed the entire screen), we have some : : 49 ae "“47F A000": REMar k LEA XORIGIN, AS 
hoe . ‘ So A “36BC0000": REMark MOVE .W Oy AS 
tidying up to to. First, if we are going to USE 1140 DATA » A7FAOO7A":REMar k LEA Phin ie: 63 
the parameter block again to process anoth- 1470 DATA “3&BCOG00": REMar k MOVE. W : 
er screen, we need to reset XORIGIN and 1190 DATA "43FA0O74":REMar k LEA 
41190 DATA "2051": REMark MOVEA.L 
FOFIGIN to he top let comer ofthe screen. | 1200 a “7ooe nears reve 
1 | : 3 i210 DATA "442": REMark TRAP 
before returning to SuperBasic. 1220 DATA “45FAOOSE":REMark Lea 
Apart from the lines altering XORIGIN and RBS DAA “Sess * eenark MOVEA.L 
YORIGIN (which are specific to this particular | j3so bata “see2"cneMeck Scag 
program), what we have covered so far is a 1260 DATA “4E75":REMark RTS 
method af analysing every pixel on the oN ae cnet Fh i aaa MOVEM.L AO-A7/DG-B?, 
screen, and then branching to an appropri | {290 pata “cooocoz2"s Remark BRA DRAW 
ate routine according to what colour the 13200 DATA "48E7FFFF":REMark MOVEM.L AO-A7/DO- 07, 
pixel we find. What those routines will be will eres econ ala _ MOVE.B #4,D1 
. . S2¢ om fs ark BRA DRAW 
depend on what you intend to do with the 1230 DATA “49E7FFFF"sREMark HOVEN: L WWI Be 
information. As | mentioned before, the clas- 1340 DATA "123COOEO":REMark MOVE. B #$E0,D1 
sic situation is using the information to a Se oe ee BRA DRAW 
, j {_ 3 * "sREMar MOVEM. L AO=-A7/DG-D7 ,- iF 
printer screen dump routine, where appropri 1370 DATA “123C00D4"sREMark EWE! & . SRO ba 
ate codes are sent to the printer to make a 1580 DATA “43FA0028": REMar k LEA ID,Ai 
printout of your screen. This requires a good tena sas Bsa ee MOVEA. L (AL) AO 
‘ . y A O026"3 REMar k LEA BLOCK, 
manic of your printer manual, and L410 DATA *7USE™ TREMer a bau he 
varies greatly from printer to printer. 1420 DATA “76FF":REMark MOVEQ #-1.D5 
Other applications may include producing oe ae placa TRAP #3 
i . m a5 ark LEA XORIGIN, 
a compressed screen file, or simply count- (ASO DATA HESS hEREMELE a SERCH N yi 
ing how many pixels are a particular colour, 1460 DATA “4COFFFFF":REMark MOVEM. L (A7)+,DO-D7/Aur fF 
or finding out exactly where a particular Tete BRA 
block of colour starts and ends. You could | {eo pata “eoos"srenore : age 


turn the picture upside down or back to 1500 DATA "0200":REMark 


front, or, with a bit more difficulty, put it on its pate mace Bere tad 
j ; 20 ae ark 
side. To be completely silly, you could make | is26 pata *0000":REMark 


each colour play a different sound, and tum 1540 DATA "00000000": REMark . 1D C $EdmOAGOd: 
your picture into music! 1550 DATA "90G1":REMark - BLOCK 7 £0001 
But, as promised, we shall tum the picture A380 DATA SO001": REMar ke $0001 
inh bari ibe Sheree Gi he p 1570 DATA “OO00":REMark .XOKIGIN $0000 
g A 1580 DATA "0000": REMark -YORIGIN DC. $0000 
Our routine to colour a block on the 1590 DATA “GOQOG000":REMark .FILE a s0000000U 
. : 1600 DATA "OG0C":REMark ~ TEXT i $0000 
screen will alter many registers. In order to 1410 DATA "46494045204E414D4520EF 20" . 
deal with this we save all the register on the 1620 REMark ve “FILE NAME 


stack with a MOVEML instruction. So this is 1630 DATA "0000": REMark ; £0000 
what the first line does whether we branch ae ll a 
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to BLACK, GREEN, RED or 
WHITE, It is not necessary 
to save all registers, but 
rather than work out which 
do and do not need saving, 
it's simpler to save the lot. 

Colouring a block is a 
TRAP #3 routine. It first 
requires the colour of the 
block in register D1. BLACK 
moves zero into D1 for 
black, and GREEN moves 4 
into D1 for green. RED 
moves $224 into D1 to give 
a green/black chequered 
stipple, and WHITE moves 
$212 into D1 to give a 
green/white chequered stip- 
ple, The rest is the same 
whatever colour, so they all 
branch to common code, 
DRAW. The console chan- 
nel ID is required in AO, and 
the address of the block 
parameters is required in 
A1. $2E is required in DO to 
tell QDOS that the TRAP #3 
routine is going to colour a 
block of screen. We put -1 
in D3 to tell QDOS to keep 
going until it has finished 
the routine (infinite timeout), 
The trap call will then carry 
out the routine. 

After returning from the 


routine, we need to incre- 
ment XORIGIN ready for the 
next pixel to the right. Finally 
we use a MOVEML instruc- 
tion to restore the registers 
from the stack, before 
branching back to RET to 
process the next pixel. 

The whole listing ends 
with the parameters, etc. 
The only part that needs 
any mention is the block 
definition, four words. The 
first two are the width and 
height of the block. Since 
we are drawing a pixel 
sized block, these are both 
1. The other two are the X 
and Y origins, and these are 
set at zero for the top left 
comer of the screen. These 
need their own labels, 
because they are continual- 
ly altered as pixels are 
drawn over the entire 
screen. 


Mods to Try 


| have mentioned one or 
two things you can try to 
modify the listing once you 
have got it working. 
Unfortunately, they are 


mostly concerned with what 
you might do with the infor- 
mation the routine gathers 
about pixel colours. None of 
them have much to do with 
the heart of the routine, 
which is looping through 
the screen pixels to see 
what colour they actually 
are. There are other ways of 
doing this, but you are not 
likely to discover them from 
what has been said so far. 
One that is worth trying is 
this. The rotate instructions 
pushes the bit that falls off 
the end into the carry bit of 
the status register. So we 
could move the word from 
from screenraminto a data 
register and then “rotate bits 
to the left" with a ROL 
instruction. This would 
cause the right most bit to 
go into the carry bit which 
could then be tested for a 1 
with a “branch on carry set’ 
or BCS instruction, or tested 
for a zero with a “branch on 
carry clear’ or BCC.This 
method might have the 
advantage in only requiring 
a ROL while the original list- 
ing requires a ROR followed 
by an AND to do the same 


job of isolating a bit for 
analysis. But it has the dis- 
advantage of only testing 
one bit at a time, while ROR 
plus AND can test two, or 
any number of bits up to 32 
at once. We used it to test 
two bits at a time, one in 
the even and one in the 
odd byte. Since the colour 
depends on two bits, the 
extra code needed might 
outweigh any advantage, 
Anyway, if you feel confi- 
dent, you might like to give 
it a try. 

As in part 7, | have loaded 
data into registers for vec- 
tored subroutines and trap 
calls without checking to 
see if the required data is 
already there. You will 
almost certainly be able to 
reduce the length slightly if 
you look for redundant lines 
of code and remove them. 

Listing Two is a short 
SuperBasic program to load 
and run the code. 

Once again, Listing 
Three is Marcus and 
Simon’s Hex Loader for 
those who do not have an 
assembler. 

Happy coding! 
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W.N. Richardson & Co. 


18-21, Mesboune House, 
(Chkeen rl. 
Chalfont S.Peter, SLS SUE 


All Prices Include 17.5% VAT 


ASK FOR DETAILS OF ECONOMY RANGE OF F.D.D. UP | 
HDD UP TO 44MR 


COMPLETE SE Some PSU, TV. Lead, PSIG W245 Software (Word Procesan, Spreadsheet, 
& Busuness Graphics), Handbook for QL, Programs . £& Supectasc, 
Pe yrs meth QUANTA te dent OL User £ pee ae mr tree Oe 
free lheary progress, 6 MONTHS Wake 


Ty ati ANY, 


(A FEW LEFT) 
Newsletters dc 

PART EXCHANGE £30 OFF ABOVE, Seud in old QU (U 

BACKUT Obs 


Accessories j 


JOYSTICK wath Qh Lead (inc inberface required) 
* QOL MOUSE, 3 Button, Software coqyolled, externally asunte 


TANDATA MODEMS 


Jy, ay conditions - 
QL & PSU only. 15 230 TEs ov chia dlnaaa EIS ae 


NOTE: EXTERNAL {SEK2) 3 BUTTON MOUSE AND SOFTWARE 
WITH EXTRA FUNCTIONS, NOW HERMES COMPS TRL 


PO KEYBOARD INTERFACE, for Bid yea PITTING, wab lead to (02 KEY KEYBOARD 

PC KEYBOARD, UK version. 102 key (AT) ———4, £25.00 Eseor 

PC KEYBOARD INTERFACE and KEYBOARD — REDUCED PRICES ma £93.00 “5954 or 
ASB und LEAD fot EXTERNAL FITTING of Keyboard Interface for simpler assembly 


simply Sty m SER? 
[1Mb, 2Mb and 4Mb 
ECONOMY M ULTECOMPUTER FLOPPY DISK DRIVE 


JS £120 


WITH JM ROM £100.00 


IS KOM £20 70.00 


£ 60,00 
£45.00 


AGAIN IN STOCK 


ECONOMY DRIVE PRICES INCLUDING VAT @ 17'2% 
—s 1 am 


capacity: [2m | 2y JL AME | Gariee ures | | 
SINGLE Drive [_¢69 |{ ess |[ 2120 )[ | 
| TWIN DRIVES [£99 e150 |[ £199 j[ 135 |[ £175 


TELEPHONE KE: UPDATING EXISTING DRIVES. ALSO DETALLS OF HARD DISK DRIVES, 
PHILIPS 14" HIGH RES COLOUR EGA 31 DOT PITCH, FULL 85 COL 40 


! Monitors 


"Microdrive Cartridges and Spares } ] 


4 New Canridges an a wales £ 10.00 
Plasue Storage ling bea including 20 new 


WITH AMBER OR GREEN TEXT FEATURE, IDEAL FOR WORD 


(1, Poe Software W235 Includes Quill, Abscus, Archive, and Easel IN WALLET £ 18.00 
OL Pion Software Separais programs £10.00 
CHL power Supply Unt ¢ ue QL Prater YP 2? , Membrane (and res gad ct oa 
TY or Necweu “Qh Top. & Botiom Case £ 5.00 
ics rae +301 £200 zx 300 2 300 49 GPC) 10 Mc 1377 £ 3.00 
Wh SLA VICE MANUAL & CIRCUITS 25.00 z 3 
Aso e 
EEL Payment ierms: Delivery: 
@ =] CWO, Access, VISA et cetera Carriage « £9 


Cheques = allow 10 days 
roduet subject wo availability, F&O 


PROCESSING, RECONDITIONED, 90 DAY WARRANTY. 
OK FOR PC AND QL SELF SENSING AND MANY EXT/L CONTROLS. 
“MONO OPTION* WITH 


prog carts for reformatting in 2 wallets. 


MOBILE: 0850 597650 | 
TEL: 0753 888866 PAY: 0753 887149 is 


Postage - £5 


MINERVA 


The ULTIMATE operaung system upgrade 


MINERVA RTC (MKID) - ty fie 256 vars cant 
tC RASHPROO# clock de Phaliy hus tor unlertinc any: 
Cat suibubiot front baby hae bcd sate. Qaich Start-up, 


Other features common to MKURTC(MK 11) 


edt GGED Aperatica: syst 
udaph tian 


“a A 97 anw with Bait an 
Multihatsn ste ea re a Ou TI PLT haul rates wath Hermes. 


Ist upyrade. free. Otherwise £3 (+ £8 for manual if 
coqud) Sema sac, Minerva & NEW dinky + mys 
MK ito MKII upgrade - £40 


Ki... £40 MKII(RTC)... 


£65 ) 


Faulty OL board ( ao plug-in chipa).......... £9 
Keyboard membranc £9 Circust diagrams .......... fa 
6HUS cpu 8 L377 PAL 
JM ROMA. Power supply. 
8302 ULA LI 83801 ULAL 7 
8049 IPC 48 MDV ULA,, 


Ofher componcniisockets etc) please phone 


Fiacd price for unmodified QLs, cact microdrives. 
QLs tested with Thom-EMI mg and ROM software 


J27T including 6 month guarantce 


HERMES 


A replacement QL co-processor cl 
the QLs awful IPC 8049 


Do you get keyboard hounce’? 

~ Bo you fund fast serial input oneekeatley 

' De you want to connect a mooem at 19200bps. 
Lf you cam say onc YES , then you uced HERMES 
19200hp, RELLABLE sar 
'ncdkepecticherd uopmal awed Ty 
Stops keyboard bounce (ul 
Improves ‘tuzzy” anc ‘ras 
Prive cxtra uipugienilpeat Lue, 
Key click, 


pe NO CONNECT 
SrTiai blows Ae pone 
peat Ss} 
J 


Fimo ws saigike  Reunee Uye CL tape dE serra. 
foplace the tip mired SU4Y oe S744 KL i mide 


£25 including manual/sohware: 


I°C Interfaces 


The FC bus was designed by Phils to simpiity 
mtertacing Minerva MK) clock is driwen by ant 12 
chip, & a commector allows connection of other cacy it 
Our uteri! cmouins will intereommost wth Kets. 
Upto $ duertaces ca be parwurodott in QL 


Parallel loteriace gives 16 mpulfoutput Lines, 
Cam be used for Jegie level output 
eg model rau controllers, Cao impat direyt te 


motor drivers (ey L293/1.298)...... oe as) 


Avaloguc Joterlace Hach gives & analog to 
digital mputs, and 2 digitalanalogus outputs. For 
temp measurement, sound sampling cac........290 
Data sheets. (analogue/parallel 1C otiped..... £2 
Cootrol software/manual (Supermasx: exins}..... £2 
(First interface purchase uuiudes tree LSDY9D wail) 


' oBss - Uks frit QL scrolling Bulloun Board 
Note the mew telephone number below 

TANDATA callers add SIX 2cron COOODU) cor wea el 

for a seconds of modem tone if dialling. manually 


Prices include post é packing (UK only), Paymeat by Mastercard’ ¥ ika/A ccons/ Burocarnd/ cheque) postal arder/ PC) 
Giro transfer (58 267 3909). MAIL ORDER ONLY - ao callers without ringing first, Ring for oversoas priors 


Holly Corner, Priory Road, ASCOT, Berks, $L5 8RL 


Tel: 0344-890986 


Fax & BBS: 0344-890987 


MasterCard 
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DATABASE SOFTWARE 
COCKTAILS WAITERE10 00 
UAT A DESIGN 3 csincesiscenssrsritorasgpcticanteoenccigacnnisieae £60.00 


SUPER DISK INDEXER sssesocssovsssecroovnsooon "£12.00 


DTP & CLIPART 

PAGE DESIGNER 3 sissssiscsernmnrsennnnismccanisnnn £40.00 
Available at last! 

UPGRADE FROM PD2 .-roscsssssecnnssesssseenrrinnseenneen £25.00 


QUESTION MASTER U.. Saba alunos £1 0.00 
QUIZ MASTER 2 (UD sississvseoasisinncsutivensesvssrnsanis £12.50 


Dilwyn Jones Computing 


41 BRO EMRYS, TAL-Y-BONT, BANGOR, 
GWYNEDD, LL57 3YT, GREAT BRITAIN 
FAX/TEL: (0248) 354023 


GENEALOGY 

GENEALOGIST 3 ceeeareecsosssnesssessssssnnsneee 
new pointer driven version 

Upgrade 2rd Edition .......ssecvsesssessecsssee 
upgrade other versions, ask 
GENEALOGIST 2ND EDITION .cswsssssssssesssserserrrr£30,00 
BUDGET 128K GENEALOGIST (U)-ecooseesreen 12.00 


cece LO 


saderiesersttotsimi SOD 


GRAPHICS 


TMAGE-D AD sescscsenssmencmensemnns 
IMAGE PROCESSOR .escsesesssssresesrsee 


PICTUREMASTER PLUS +o. 
QRACTAL seosscsrsneeemenrnee 
QUICK MANDELBROT 3 To) = 
SCREEN COMPRESSION ......... 


VOICE ANALYSER-New! 

Ask for details and price 

Add £2 50 postage for MPC, 
SERMOUSE AND VOICE ANALYSER 


MAGAZINES 

REVIEW occ 

QL TECHNICAL REVIEW ........ 

issues 1-8 available 

QL ADVENTURER’S FORUM uevcsusssssnsssssssssseenroner£ 75 
Issues 1-9 available 

ME EERSORE FEV IEW ssisivctsceiisivenssstinsntiaibnenstbion’ intense OD 
issues 1-2 available 

{UK prices only shown) 


MEGATOOLKIT DISK (U) ssresrsserenarernererrcsnrn£ 25x 
MEGATOOLKIT EPROM (Up cesooveomomeoeerererrersern £4 0,00 
QLIBERATOR 3 36 .oseosssne 

BUDGET QLIBERATOR (U) ~ i 
QLOAD AND QREF (U) svocsetsrscsos ieniatetsittacinaou SAM) 
SS EDIT EDITOR .eevmeveorsseocverssrnseressenscvnnssere ssvesennh 20.00 


TERMS: POSTAGE-sofiware sent post free to UK, overseas add £1 00 per program (maximum £3 00) Floppy disks, SERmouse, etc add £2 50 postage (see 
aa above) PAYMENT - IN UK currency (pounds sterling) only, please Valid methods of payment are cheque drawn on UK branch of bank or building 
= Society, Eurocheque, Postal Order, cash (send by registered post) or by credit card - Visa, Access, Mastercard and Eurocard accepted Please make cheques 
etc payable to DILWYN JONES COMPUTING Minimum order value £5 00 (due to bank charges) Goods remain property of Dilwyn Jones Computing 
until paid for in full Orders normally sent out within a few days of receipt, we will attempt to advise if any delay anticipated due to stock problems Orders 
can be accepted by telephone if paid for with credit card Orders paid with credit card can only be sent to cardholder’s address under card company rules 


FAX - We now have a Fax machine on our usual number (0248) 354023 


SCREEN DUMPS 
SIDEWINDER PLUS cvcssssessssesssssernnnnseseersscenasernsen hd 4 IS 


BD TERRAIN vssssoorsonersssossnennersnnsstrinerennnerenepegpeaanes wo 12,50 


SUNDRIES 

3 5” DSDD DISKS @€ch esos 

3 5” DSHD DISKS €ch -rrsoorn 

3 5” DISK LABELS (roll 100) o...sos 

3 5” LABELS (printer roll) 

ADDRESS LABELS (roll 100) seoocrseemoerenen 


MDW LABELS (roll 100) ssesceosetneee 


3 5” DISK DIVIDERS (20) .secavreseeeremeseemene aig 
Add £0 50 postage for labels or mouse 

mat if only ordering those, or £2 50 postage 
for disks or disk box divider sets 


THE Pointer Environment package! 

OTOP ssscisecsncrscssousssnaseceeap sist iesaghec symone one £29,95 
SCREEN TRADE T IDR sissieicscpstecsissinsc nineteen ovomie 1 5,00 
SCREEN ECONOMISER (U) ossssssssosssee seniors 1000 


CALL OR WRITE FOR A FREE COPY OF 
OUR QL SOFTWARE CATALOGUE 
DETAILING AROUND 100 QL PRODUCTS 


PLEASE NOTE: (U) ABOVE MEANS THAT 
THE SOFTWARE IS SUITABLE FOR USE 
ON A 128K QL 


